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demos of Windows applications. 

DemoShield4 gives you the power to 
effortlessly create convincing point-and- 
click product demos, presentations and 
tutorials of your 
application. 

Simply use a 
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your own 
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effects—all 

without programming. DemoShield4 
gives your customers a chance to interact 
with your application in real time while 
experiencing key product features. 
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With MapObjects, 

users can 

• Pan and zoom 
through multiple 
map layers 

• Display data using 
classifications, 
graduated symbols, 
labeling, and dot 
density 

• Display a variety of 
image formats 

• Use relational 
databases and SQL 
queries 

• Perform spatial 
analysis and query 

• Perform address 
geocoding 

• Track real-time 
events (GPS) 


MapObjects™ is a collection of mapping and GIS components consisting of an OLE Control and a 


Plus: 

Lots of data 


collection of over 35 programmable OLE Automation objects. MapObjects is by far the largest component 
library of GIS software. With very little programming time you can add dynamic, live maps and GIS 
capabilities to your applications. You can use MapObjects with popular programming environments such 
as Visual Basic®, Delphi®, PowerBuilder®, and Visual C++. 


including streets, 
census boundaries, 
ZIP Codes, states, 
countries, and 
much more 


Because MapObjects is from ESRI, you can be assured you are getting industry-standard, technologically 
superior mapping and GIS functions. That’s because ESRI is the world leader in digital mapping. We have 
built our reputation by making mapping software that helps you accomplish tasks faster, easier, and better. 

# MapObjects 

Put a Map in Your App 



1 - 800 - 447-9778 

Fax: (909) 307-3039 

E-mail: info@esri.com 

Web: www.esri.com 

International: (909) 793-2853, 
extension 1235 


Copyright © 1996 Environmental Systems Research Institute, Inc. All rights reserved. ESRI is a registered trademark; MapObjects, the ESRI globe logo, and the MapObjects logo are trademarks; and 
©esri.com and www.esri.com are service marks of Environmental Systems Research Institute, Inc. Other companies and products mentioned herein are trademarks or registered trademarks of their 
respective trademark owners. 
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If you need to perform port I/O, do you have to write a driver or is it OK to just do direct 
INs and OUTs? If you don’t write a driver, will your port I/O be really slow? This article 
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Microsoft created the Control Development Kit to allow the creation of VBXs, but it is 
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Let s face it - when you need a disassem¬ 


bler you're looking for clear, reliable informa¬ 
tion. Those who have tried other products 
have been disappointed with the dismal re¬ 
sults. 

Clearly, a new standard of excellence! 

Sourcer solves these problems with ad¬ 
vanced analysis and simulation. The quality 
of output is so good that most DOS EXE & 
COM files and drivers reassemble perfectly, 
byte-for-byte identical to the original! 

To make the results easier to understand 
Sourcer provides detailed and descriptive 
comments for interrupt subfunctions. I/O 
ports and much more. Sourcer even lets you 
examine encrypted and packed programs. 


mov 

ax,2517h 



dx.offset int 17h entry 

int 

21 h 

; DOS Services ah=function 25h 
; set intrpt vector al to ds:dx 
; ('Halt when ? printed.') 

mov 

dx,offset data 4 

mov 



int 

21 h 

; DOS Services ah=function 09h 
; display char string at ds:dx 

mov 

dx,19h 



ah,31h 


int 

; DOS Services ah=function 31 h 


; terminate and stay resident 
; al=return code,dx=paragraphs 


virustst endp 



int_17h_entry proc far 
pushf 

; Push flags 

cmp al,3Fh 



Partial Disassembly of a Virus 


C/C++ and Pascal 

Some C, C++ and Pascal developers hate 
disassembly because the source code they get is 
assembly. We can't change that, but we can 
make it easier for you by automatically identi¬ 
fying the use of parameter passing and local 
stack variables. Parameters pushed onto the 
stack prior to a subroutine call are clearly com¬ 
mented. 

Get commented BIOS listings 

The BIOS Pre-Processor creates commented 
listings for any BIOS ROM. Understand how 
your specific BIOS works! Adds over 75K of 
comments specific to your BIOS. Inserts labels 
like "int_10_video”. And it's fully automatic. 

Windows disassembly! 

Windows Source generates detailed listings 
of Windows EXEs, DLLs, VxDs, device 
drivers, & OS/2 NE files. Windows Source 
labels, by name, export & import function calls, 
API calls like "GetModuleHandle", undocu¬ 
mented APIs, VxD functions and much more. 

Call now! 
1 - 800 - 648-8266 


Sourcer $149.95 

Sourcer & BIOS Pre-processor 189.95 

Sourcer & Windows Source 249.95 

Sourcer, BIOS & Windows Source 289.95 


Shipping: USA $6; Canada/Mexico $10; All others $25. 
CA residents add sales tax. © 1994 VIS/VMC/Amex/COD 


30-DAY MONEY-BACK GUARANTEE 



V Communications, Inc. 

4320 Stevens Creek Blvd., Suite 120-WD 
San Jose, CA 95129 408-296-4224 
FAX 408-296-4441 



From the Editor 


Note to vendors: raise your odds of appearing in our New Products section by including the following 
standard pieces of information in your press release: company name, company address, company phone 
number, product name, product price (important), what platform the product runs on, what the product 
does (or how this version differs from previous versions). Optional but useful information includes: compa¬ 
ny fax number, company email address, company Web site (including your URL gets you a free link from 
our Web site during the month your product appears in New Products). Send all press releases to the Kansas 
office, not to me. With apologies to all the vendors I'm passing over, I want to mention some products I found 
interesting at Software Development '96. Remember to tell them you heard about it in Windows Developer's 
Journal ! AT Intel was showing VTune 2.0, a profiling program that helps you locate and revise any CPU 
hotspots in your program. It's a sampling/histogram style of profile, but I was surprised at the amount of 
polish and smarts built into it. If you're the one they call when the code is too slow, check out VTune. 
www. i ntel. com/i a 1 /vtune/ AT WallData has rearchitected their Rumba mainframe connectivity software 
using OLE, so now programmers can create robust custom solutions but still let Rumba code handle talk¬ 
ing to the big iron, www. wa 11 data. com. AT ParaSoft's new CodeWizard analyzes your C++ source code and 
tells you when you violate a set of canned rules (e.g., avoid public data members). It was a nice demo, but 
what really interested me was their comment that the next version will let you define your own rules. If 
they can make that easy (or even just moderately difficult) they may have a must-have product for big 
C++ projects. Imagine having a tool that can automatically locate violations of high-level C++ conventions 
you've agreed on for a particular project (e.g., "no one should ever derive from class TFunnyBase"). 
www.parasoft.com. AT One thing that helps slow NT's success is the lack of Microsoft support for third- 
party device driver writers. Nu-Mega solved one part of that problem by shipping the first decent debugger 
for NT systems programmers: SoftICE for Windows NT. While the boys in Redmond still require a second 
attached NT machine (a whole system, not just an extra monitor!) to do minor kernel-mode debugging, 
SoftICE users can use a single machine and (shades of modern conveniences) screen swap. www. numega.com. 
AT Pure Software is entering the memory bug finder fray with Purify, a tool they already sell successfully 
on UNIX. I figured this would be portable (e.g. they make a modified copy of your source and you have to 
rebuild to do checks) and a pain to use. It's not — this is a gung-ho analyze-your-.exe- and-make-a-patched- 
version-on-the-fly tool that can go after most any kind of memory access problem. That explains why it has 
taken so long to port, and why they might have a chance against BoundsChecker and SmartHEAP. 
www.pure.com, AT Algorithms for truly automatic garbage collection for C/C++ have been floating around 
academia for years. Now they've entered the Windows programming market with Geodesic System's Great 
Circle. How does it work? Think brute force: to figure out which memory chunks no one refers to anymore, 
start by scanning all data segment variables and all stack variables, and keep going recursively every time 
you hit something that could be a valid pointer. Sounds impossible, but it can work without being too ineffi¬ 
cient (hey, you can drop all those calls to f ree( ) and del ete), depending on your pattern of memory use and 
how smart the implementation is. www .geodesic, com. AT Speaking of memory management, MicroQuill was 
also present with SmartHeap (faster memory management) and Heap Agent (track down memory manage¬ 
ment bugs). I didn't stop there for a demo, but to talk to the experts about why some compilers' memory 
management (ma 1 1 oc( )/f ree( )) is incredibly slow. You'll want a list of all the vendors who sell faster mem¬ 
ory management solutions when you see next month's head-to-head benchmark of compiler memory man¬ 
agement. www.microquill .com. AT Do you work on projects with complex formal requirements? Wouldn't 
it be nice if you could write and maintain the requirements in your word processor, and yet still manage the 
requirements as a database (e.g., display all the requirements that this module is related to)? Requisite works 
this magic by letting you maintain your requirements in a WinWord document, but maintaining links to 
specified parts of the text in their own database, www .requisite, com. AT Want to embed a C-like script lan¬ 
guage in your product? Nombas has the answer with their Cmm toolkit — and it fits in 64Kb. 
www. nombas. com. AT Borland C++ v5.0 finally shipped, which is good for two reasons. First, Microsoft does 
not support dual 16-bit/32-bit Windows development (do you really want to rely on the 16-bit compiler they 
stopped maintaining years ago?); Borland is now the only compiler vendor with significant market share 
supporting dual development. Second, Borland C++ v4.5x came with an out-of-date Win32 SDK, so it was 
not ready for Win95 (Watcom 10.5 has the same problem, but Symantec C++ shipped with the good SDK). 
I'll be looking closely to see how solid their Win95 and NT support is, but I switched to the new compiler 
during its beta and so far I've hit few snags. 

Ron Burk 


Editor 

70302.2566@compuserve.com 
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Save months of TCP/IP programming! 


Fill in properties 




* * * Write a little code 






Object 3 *’«= |SS 

d 

Private Sub Ca—wwitljCticfc j ) 

* Omatct to the FTP Server 
FIKUttt.ictiW * JBCTXflWjCfiMttCT 
' Transfer Senate File to your machine 
FTPClieat. File Action* - PIUE ACTION GET 
End Sub 

i 

«U 


OLE Custom Controls 

Just ask any OCX jockey. With Distinct’s Visual Internet 
Toolkit, adding TCP/IP connectivity to your application 
is not much farther than a drag-and-drop away. 
Whether you need a customized FTP client or most 
any other Internet application, you can simply embed 
an OCX into your program and Visual Internet 
will do the rest. It’s that easy. And you’ll have 
great looking, powerful applications. 


Protocols 

• Windows Sockets 

• Telnet 

• TCP/UDP/ICMP 

• VT 220 

• PPP/SLIP/CSLIP 

• WinSNMP 

• E-mail/SMTP 

• ONC RPC/XDR 

• POP 2/POP 3 

• rep 

• News/NNTP 

• rexec 

• FTP 

• rlogin 

• TFTP 

• rsh 

• TCP Server 

• And many more 

Interfaces* 

Environments 

•32 bit (95 and NT) 

• Visual Basic 

• 16 bit (Windows 3.x) 

• Visual C/C++ 

• C++ Class libraries 

• Delphi 

• DLL's 

• C/C++ 

• OCXs 

• Access 

• VBX’s 

• FoxPro 


32 Bit Performance 

The power of our new 32 bit Visual Internet Toolkit 
is simply unsurpassed. More custom controls. More 
protocols. More sample code. More Documentation. 
Which makes your job easier and leaves the 
competition in the dust. 



Call now for 
30 minute 
Internet 
Delivery! 



Jfc > . 

distinct 



u 408.366.8933 

World Wide Web: http://www.distinct.com 
Fax: 408.366.0153 

E-mail: windev@distinct.com 

Fastfacts: 408.366.2101 


•Not all interfaces may be available for all protocols. Ucensuig fees required for redistribution. Distinct is a registered trademark and 30 minute Internet Delivery! and Msual Internet is a trademark of the Distina Corporaiion. Cq>yrighi 1995 Distina Corporation, 12900 Saratoga Avenue, SaraK^a, CA 95070. All rights reserved. Speafications and delivery terms are subject to change wilhoul notice. 
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Debugging 


Enhanced MFC Debugging 
Traces 

R. Keith Elliott 


E033 

Visual C++ V4.0 




Different people and different problems seem to lend themselves to different 
debugging techniques. Over the years, I've learned to rely on the simple program 
trace as my primary tool for resolving certain programming problems. A trace is 
essentially just a record of a program's execution, kept in some kind of text log. The 
log usually includes such things as function labels, snapshots of variables, and cus¬ 
tom messages provided by the programmer. 

Although there are certainly times when using breakpoints and watch variables 
can be more effective than using a trace, a trace provides some valuable benefits not 
found with other debugging methods. First, creating the trace doesn't interfere with 
operating the user interface or generating a display. Have you ever tried using break¬ 
points to find a problem embedded inanOnDrawO message handler? It can be a frus¬ 
trating experience. Second, comparing the trace from two different execution loops 
can be a handy way to discover what the buggy loop is doing differently from the 
non-buggy one. Third, the trace lets you work on more than one problem at a time. 
Finally, you can turn the trace on or off at run-time, by using the "Enable tracing" tog¬ 
gle on the MFC Trace Options utility. You can also conditionally compile the trace so 
that it only operates in the debug build. This lets you leave the tracing logic in place 
without having to worry about it showing up on a release build; it doesn't even need 
to be commented out. The next time that code needs tracing, the programmer charged 
with the task will be grateful to find all of the tracing logic intact and easily enabled. 

In the past, no matter what programming language I was using, I usually man¬ 
aged to put together my own generic canned routines for creating a trace. When I 
first started to use the old Zortech C++ compiler, one of the first things I did was to 
create a tracing class. Then when I started to use Microsoft's C++1 renamed the class 
CT racex and altered it to use MFC's trace macros to display the output. This way the 
trace display would go directly to the output window. 

You might be wondering why I would want to use my CTracex class when 
Microsoft has already provided trace macros. The main reason is that the CT racex class 
displays tracing information within a context-rich display that I find to be of far greater 
utility. In addition, the CTracex class takes care of some formatting and conditional 
compilation needs that make it easier to use. The most notable feature of the trace out¬ 
put is the use of staggered indentations to indicate the relative placement within the 
call stack; indenting helps place the debugging output in a call tree context. Figure 1 
shows the difference between the simple style of trace output and the automatically 
indented style that CTracex provides. 


R. Keith Elliott has been programming for over 20 years. He is currently employed as 
Project Leader for the The Product Software Development group at McGraw-Hill/London 
House. He can be reached at 75677.504@compuserve.com or at RKElliott@aol.com. 

June 1996 








The Wise Installation System is a Windows based installation editor that creates 
professional setup programs in hours, not days. It creates a single installation that runs in 
Windows 3. lx, Windows NT™ or Windows 95®. It comes complete with both Win 16 and 
Win32 versions, creates shortcuts/shell links for use with Windows 95, handles nested 
components and has a full uninstaller. It is completely customizable to fit your needs. 
Order now and stop looking for that missing piece! 



To order call 1 - 800 - 554-8565 
or use http://www.glbs.com 

to download a fully functional demo. 
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Figure 1 Indented versus flat trace output 


Simple trace output: 

attempting to create mAppi... 
instantiating mAppReg... 
instantiating mDocTemplate... 
adding doc template... 
pDatabase->GetConnect() — 
mIOpenedOatabase — 0 
mIOwnDatabase — 0 
mAppi created OK... 
creating mAppix... 
instantiating CRptState... 


Trace output using the TRACEX macros: 

CTestApp::Initlnstance 

CTestApp::Initlnstance : attempting to create mAppi... 
CAppi::CAppi 
CAppi::init 

CAppi::init : instantiating mAppReg... 

CAppi::init : instantiating mDocTemplate... 

CAppi::init : adding doc template... 

CAppi::init exit 
CAppi::setOatabase 

CAppi::setDatabase : pDatabase->GetConnect() — 
CAppi::setDatabase : mIOpenedDatabase — 0 
CAppi::setOatabase : mIOwnDatabase ~ 0 
CAppi::setDatabase exit 
CAppi::CAppi exit 

CTestApp::Initlnstance : mAppi created OK... 

CTestApp::Initlnstance : creating mAppix... 

CAppix::CAppix 
CAppix::init 

CAppix::init : instantiating CRptState... 
CRptState::CRptState 
CRptState::reset 


How CTracex Works 

The source code for my trace package resides in tracex.h 
(Listing 1) and tracex.cpp (Listing 2). The basic technique is to 
provide an object whose constructor increases the indentation 
level and whose destructor decreases the indentation level. 
When such an object is included as a stack variable, the compil¬ 
er will ensure that the constructor is called at function entry and 
the destructor is called at function exit. The CTracex constructor 
takes aCStringasan argument and, when instantiated, displays 
the CStri ng at the appropriate indentation level, which is main¬ 
tained simply as a static integer. The CStri ng contains the name 
of the member function so the CTracex destructor can display 
the same string, followed by the word "exit". In this way, the 
user need only create a CT racex object on the stack at the begin¬ 
ning of a function. When the object goes out of scope and the 
destructor is called, an exit message is automatically displayed 
and the indentation level is decremented. 

In an early incarnation of this class, I found myself writing 
code something like this: 

CMyView::OnDrawf) 

(CTracex tTraceC"CMyView::OnDraw"); 
tTrace.msgC'Beginning drawing sequence..."); 

It didn't take long to realize that it would significantly improve 
things if I had the ability to conditionally compile all of the 
CTracex operations out of existence. To achieve this, I added to 
the header file a handful of macros that act as the programmer's 
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interface to the tracing mechanism. These macros get compiled 
into oblivion unless the keyword TRACEXON has been defined. To 
enable tracing, you must define TRACEXON before including the 
header. For example: 


//define TRACEXON 
#include <tracex.h> 

The primary macro is called TRAC EX and takes a string argu¬ 
ment. This macro simply instantiates a CTracex object with a 
standard name (tAutoTrace). Macros for displaying messages 


Listing 1 tracex.h — Header for tracing class 


// tracex definition 

// Author: Keith Elliott 5/95 

// 

// tracex can be used to produce formatted trace entries 
// with indentations to indicate the call stack. To use. 
// simply instantiate a CTracex object on the stack at the 
// beginning of those functions that you want to trace. 

// Use the function name in the CTracex constructor. The 
// CTracex object will automatically display a message to 
// the Microsoft TRACE output at the current static 
// indentation level. It will then increase the static 
// indentation level. When the object is deleted as it 
// goes out of scope, it will decrease the static 
// indentation level and display a message that the exit 
// was reached. 

// 

// The TRACEX macro has been provided to allow conditional 
// compilation. In order to display a message at the 
// current indentation level, use the TRACEXMSG, 

// TRACEXMSGVAL, or TRACEXWATCH macros. 

// 

// Output example: 

// . 

// CTestApp:lnitlnstance 
// CQri::CQri 
// CRepPage::CRepPage 

// CRepPage::CRepPage exit 

// CQrSheet::CQrSheet 


// CQrSheet::CQrSheet exit 
// CRepPage::SetDocTemplate 

// CQrdvView::CQrdvView 

// CQrdvView::CQrdvView exit 

// CQrdvView::setQrSheet 

// CQrdvView::setQrSheet exit 

// CRepPage::SetDocTemplate exit 

// CQri::CQri exit 
// CTestApp:InitInstance exit 
// 

// The macros will expand out to a semi-colon unless 
// TRACEXON has been defined. You can use these macros 
// throughout the implementation of a class/module and can 
// enable trace output for a module simply by defining 
// TRACEXON before the header statement. This provides an 
// easier mechanism for placing a class/module into 
// "trace debug" mode that having to repetatively 
// comment/un-comment code. 

#undef TRACEX 
lundef TRACEXMSG 
//undef TRACEXMSGVAL 
//undef TRACEXWATCH 

#if defined (TRACEXON) 

//define TRACEX(pString) CTracex tAutoTrace(pString); 
//define TRACEXMSG(pString) {tAutoTrace. msg (pStri ng);} 
//define TRACEXMSGVAL! pStri ng, pVal) \ 
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refer to that name. The macro-ized version of the previous 
example looks like this: 

void CMyView::OnDraw(CDC* pDC) 

{TRACEXt"CMyView::OnDraw"); 

TRACEXMSGl"Beginning drawing sequence..."); 

Creating these macro helpers means that I've taken the TRACE 
macro, encapsulated it and enhanced it with the CT racex class, 
and re-implemented it as a macro. This isn't a design tech¬ 


nique that I would ordinarily advocate but in this case it 
seems to make sense. 

The CTracex class contains a few other functions and 
macros for displaying other messages and for dumping a vari¬ 
able and its value(s). For instance, 

TRACEXMSGl"attempting to create mAppi... ”); 

would be used to generate the first message in the example. 
Note that the trace output includes the member function name 


Listing 1 continued 

{tAutoTrace.msg(pString, pVal);} 

static int mlndent; 

#def1ne TRACEXWATCH(pVar) \ 

static BOOL mTracing; 

{tAutoTrace.msg( #pVar " — ", pVar);} 

// When we have the keyword explicit, this single 

#e 1 s e 

// argument constructor should be declared explicit to 

jfdeflne TRACEX(pString) {;} 

// prevent unintentional implicit type conversion. 

#define TRACEXMSGCpString) I;} 

// . 

//define TRACEXMSGV A L( pStri ng , pVal) {;} 

CTracex(CString pMsg); 

//define TRACEXWATCH {;) 

virtual ~CTracex(); 

#end1f 

virtual void AssertValid() const; 

#1fndef TRACEX H 

void msg(const CString pMsg); 

//define TRACEX_H 

void msg(const CString pMsg, const int pint); 

void msg(const CString pMsg, const unsigned int pUint); 

(/include <afx.h> 

void msg(const CString pMsg, const long pLong); 

void msg(const CString pMsg, const unsigned long pUlong); 

class CTracex : public CObject 

void msg(const CString pMsg, const double pDouble); 

{private: 

void msg(const CString pMsg, const CString pString); 

CString mMsg; 

void msg(const CString pMsg, const CObject* pObject); 

protected: 


void tracelndentO; 

//endif //TRACEXJ 
// End of File 

public: 
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Listing 2 tracex.cpp — Implementation of tracing class 


// -—-„======== 

// tracex implementation 

// —============- ----- ========= 

//include "stdafx.h" // possibly needed for PCH 

//include "tracex.h" 

// static members 

// . 

int CTracex::mIndent = 0; 

BOOL CTracex:rmTracing - TRUE; 

// CTracex constructor 

CTracex::CTracex(CString pMsg) 

{// Remember the message string 

// . 

mMsg - pMsg; 

// If we are tracing, display a trace 

// . 

if (mTracing — TRUE) 

(tracelndentO; 

TRACE(pMsg + "\n"); 

} 

// Move the indentation level up a notch 
// 

mlndent +- 2; 

} 

// CTracex destructor 

// - ===== - ================—= 

CTracex::~CTracex() 

{ASSERT JALID(this); 


// Move the indentation level back down a notch 

// . 

mlndent — 2; 

// If we are tracing, display the trace exit message 

// . 

if (mTracing =- TRUE) 

{tracelndentO; 
mMsg +- " exit\n"; 

TRACE(mMsg); 

} 


// AssertValid 
// Inherited from CObject. 

void CTracex::AssertValid() 

{CObject::AssertValid(); 

} 

// =========== 

// tracelndent 
// Used privately to display an indentation 

void CTracex::tracelndent() 

{ASSERTJALID(this); 

if (mTracing — TRUE) 

{if (mlndent > 0) 

// crude but effective 
// . 

{for (int tCount - 0; tCount < mlndent; tCount++) 
TRACEOC' "); 

} 

} 

} 


const 
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Listing 2 continued 


n >==.=--—====__«__——.==—== 

// msg 

// Use this to display a message at the current indentation 
// level 

// —-=====—==———=======-—-— 

void CTracex::msg(const CString pMsg) 

{ASSERT_VALID(this); 

if (mTracing — TRUE) 

{tracelndent(); 

TRACE(mMsg); 

TRACE0( M : "); 

TRACE((pMsg.Get Length() > 511) ? pMsg.Left(511) : pMsg); 
TRACE0("\n"); 

} 

} 

// „— - -—-==========—--===== 

// msg (overloaded) 

// Displays a CString and an int 
/ / ==============--===== 

void CTracex::msg(const CString pMsg, const int pint) 

{ASSERTJALID(thls); 

char tStr[10]—{0}; 
itoa(pint. tStr, 10): 
msg(pMsg + (CString)tStr); 

} 

// msg (overloaded) 

// Displays a CString and an unsigned int 
/ / ================-======= 

void CTracex::msg(const CString pMsg, 

const unsigned int pUint) 

{ASSERT_VALID(this); 
msg(pMsg, (unsigned 1ong)pUint); 


} 

/ / - — - 

// msg (overloaded) 

// Displays a CString and a long 

void CTracex::msg(const CString pMsg, const long pLong) 
{ASSERTJALID(this); 

char tStr[30]-{0}; 

1toa(pLong, tStr, 10); 
msg(pMsg + (CString)tStr); 

} 

// msg (overloaded) 

// Displays a CString and an unsigned long 

void CTracex::msg(const CString pMsg, 

const unsigned long pUlong) 

{ASSERT JALID(this); 

char tStr[30]—{0}; 
ultoa(pUlong, tStr, 10); 
msg(pMsg + (CString)tStr); 

} 

// msg (overloaded) 

// Displays a CString and a double 

// NOTE: I have arbitrarily chosen to display only seven 

// digits to the right of the decimal. 

void CTracex::msg(const CString pMsg, const double pDouble) 
{ASSERT_VALID(this); 

int decimal, sign; 
char* tStr; 
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prefix. This is generated automatically using the string passed 
to the TRAC EX macro. To dump a variable, the user would do 
something like the following: 

TRACEXWATCH(mlOpenedDatabase); 

Macro string substitution is used to display the variable name 
and the == operator, and one of a number of overloaded func¬ 


tions gets called depending on the variable type. This pro¬ 
vides a degree of type safety not found when using the origi¬ 
nal TRACE macro implementation, which displays variables 
using pri ntf notation. 

The class also contains a public Boolean member — mTracing 
— which is initialized to TRUE and indicates whether the trace 
should actually be generated. The programmer may want to 


Listing 2 continued 

tStr - _fcvt ( pDouble, 7, Udecimal, &sign); 

tString += tDot; 

// _fcvt doesn't do the formatting of the sign and the 
// decimal so we must do that here. 

for (tSub - decimal; tSub < (int)strlen(tStr); tSub++) 

// . 

tString += tStr[tSub]; 

CString tString - 
const CString tDot - 

} 

msg(pMsg + tString); 

if (sign !- 0) 
tString - (CString)"-"; 

! 

if (decimal < 1) 

// msg (overloaded) 

{tString += tDot; 

// Displays a CString and another CString 

for (int tSub - 0; tSub > decimal; tSub--) 

void CTracex::msg(const CString pMsg, 

tString +- (CString)"0"; 

const CString pString) 


{ASSERT JALID(this); 

tString +- (CString)tStr; 

} 

msglpMsg + pString); 

else if (decimal >- (int)strlen(tStr)) 


tString +- (CString)tStr + tDot; 

// msg (overloaded) 

else 

// Displays a CString and calls the CObject* ' s DumpO 

{for (int tSub - 0; tSub < decimal; tSub++) 

// member. 

tString +- tStr[tSub]; 
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Listing 2 continued 


void CTracex::msg(const CString pMsg, 

const CObject* pObject) 
{ASSERT_VALID(this): 

CString tSep = -— 

msg(tSep + " " + pMsg + " dump " + tSep); 

#1fdef _DEBUG 
pObject->Dump(afxDump); 

#endif 

msg(tSep + " end of " + pMsg + " dump " + tSep); 

} 

//End of File 


use this to programatically turn the trace on or off. A typical 
usage would be to turn the trace off for the first 9,999 times 
through a loop but to turn it on for the 10,000th repetition when 
you know that a bug appears. 

When I am creating a new class, as a matter of course I will 
insert a TRAC EX macro immediately inside almost every member 
function. I make exceptions only for those functions that I know 
are going to be called an extraordinarily large number of times 
or those that are absurdly trivial, such as most get/set func¬ 
tions. If and when I have a need to trace through this class, I can 
enable tracing simply by inserting a define statement for 
TRACEXON before including tracex.h. I have used this class in 
both VC++ 1.52 and VC++ 4.0 with good 
success. Keep in mind, though, that an 
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extensive trace of all of the classes for an 
application can slow things down con¬ 
siderably, so you might want to use the 
TRACEXON define statement and only trace 
classes when they need it. 

Summary 

I have no doubt that this technique 
could be improved and extended, and I 
would certainly enjoy hearing from 
anyone with any further ideas along 
these lines. Until then, good luck and 
good tracing. □ 
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Debugging 


Listview Bugs and Problems 

Ron Burk 


=E3= 

Borland C++ v4.5 

Symantec C++ v7.0 

mmm. 

Visual C++ vl .5 


Watcom C++v. 10.0 


Several books that cover the new Windows 95 controls have arrived on the scene 
recently. In order to figure out whether or not the books provided useful informa¬ 
tion, I decided to dive in and start using the new controls myself. Almost immedi¬ 
ately, I ran into bad documentation, poor design, and just flat-out bugs — none of 
which were mentioned in the books I was looking at. While I wasn't impressed with 
the information in the new crop of books, I decided I could at least save other pro¬ 
grammers some of the time I wasted by writing down what I've learned. To demon¬ 
strate the bugs and problems, I wrote a test program (see Figure 1) that resides on the 
code disk (see Table of Contents for availability). 

The Column-Counting Bug 

The listview control automatically lets the user change the widths of the individ¬ 
ual columns. This is a neat feature, and one obvious enhancement would be to save 
the column widths every time your program exits, then load them up again at start¬ 
up. That way, users could adjust the column widths just once, rather than every time 
they started up your application. 

I thought I could easily implement two completely modular functions to handle 
this task. My idea was to create two functions, SaveColuiwisO and LoadCol umns (), 
that would take a listview window handle and a .ini filename. SaveColumns() 
would just loop over the columns in the control and store their widths in the .ini 
file. LoadCol umns () would do the reverse operation. That's when I hit a stumbling 
block: how do you find out how many columns currently exist in a listview control? 
In fact, Microsoft does not supply any explicit function or macro to return the count 
of columns in a given listview control. 

Still, I figured there must be some way to force the listview control to tell me how 
many columns it contained. It dawned on me that I could just use 
Li stVi ew_GetCol umnWi dth( ) to kill two birds with one stone. I would have to call this 
function anyway to get the width of each column, and the documentation for the 
function claims that it "returns the column width if successful or zero otherwise." 
Perfect! I wrote the following code to save all the column widths to a .ini file: 


Ron Burk is the editor of Windows Developer's Journal and has been a programmer 
for 12 years. You may contact him at 70302.2566@compuserve.com. 
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int Width; 
fordnt Col =0; 

(Width=ListView_GetColumnWidththWnd, Col))!=0; 

++Col) 

{ 

char Name[32], Buffer[32]; 
wsprintf(Buffer, "M", Width); 
wsprintf(Name, "Column%d", Col); 

WritePrivateProfileStringi 
"Windows”, Name, Buffer, 

"goalman.ini"); 

) 

For example, if the listview control happened to contain five 
columns, this would write out five widths, then on the sixth 
column, Li stVi ew_GetCol umnWidthf) would return zero, termi¬ 
nating the loop. 

At least, that's what I thought it would do. In fact, when I 
ran this program, it didn't seem to work. I first looked at the 
.ini file to see what got produced, and discovered that the 
program had written a few hundred garbage column widths. I 
edited the garbage out and saved the file — only to notice that 
the file was full of garbage again. I'm not going to admit how 
much time I spent wrestling with this mystery before it 
dawned on me that my program was still in a loop, writing 
garbage column widths to the .ini file! 

The fact is, contrary to its documentation, 
Li stVi ew_GetCol umnWi dth() never does return FALSE. More 
precisely, I guess I cannot prove that it never returns FALSE, but 
I can say that I've observed many thousands of calls that 



should have returned FALSE but returned a really big number 
instead. 

Fortunately, there is an easy workaround for this bug — 
another function, called Li stVi ew_GetCoI umn (), that returns 
even more information about an individual listview column. 
It too is documented as returning FALSE if it is unsuccessful, 
but it actually appears to work as documented. However, it 
requires a little more work to call: 
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LV_C0LUMN Col; 
memset(&Col, 0, sizeof (Col)); 

Col.mask - LVCF_WIDTH; 

if(LIstView_GetColumn( 

ListView, ColNum, &Col)) 

{ 

// then column exists 

1 

The test program demonstrates both 
that Li stVi ew_GetCol umnWidth() returns 
garbage and that Li stVi ew_GetCol umn () 
returns FALSE, as documented, for fail¬ 
ure. When it starts up, the test code calls 
both Li stVi ew_GetCol umnWi dth() and 
Li stVi ew_GetCol umn () with bogus col¬ 
umn numbers and displays the results. 
As Figure 1 shows, one call produces 
garbage while the other returns 0. 

The Sorting Bug 

When you use the listview control in 
report mode, the user will probably 
expect to be able to press the column 
heading button to sort the listview 
items by the data in that column. 
Suppose that you created your listview 
control with a style bit that lets the user 
edit the text in the first column. 
Suppose also that you support clicking 
on column buttons to sort. If the user 
clicks on the button to sort by the text in 
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column one, and then edits the text in a particular item, what 
should happen? In my application, I wanted to automatically 
resort the items in the listview control in that situation. It 
seemed like a simple task, but led straight into another 
listview bug. 

When the user edits the text in the first column of a listview 
item, the control sends two notifications. Before letting the 
editing begin, the control sends LVN_BEGINLABELEDIT notifica¬ 
tion; you can return TRUE to permit the editing to proceed, or 
FALSE to prevent it. After the user changes the text and presses 
the Enter key, the listview control sends LVN_ENDLABELEDIT 
notification. The documentation for this notification claims 
that it has no return value. In fact, Poul A. Costinsky has sub- 
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mitted an SDK annotation pointing out that this is wrong. You 
must return TRU E to permit the user's text editing to take effect, 
or FALSE to cause the user's editing to be ignored. 

Given how the listview item editing works, I decided to just 
re-sort the items (by calling Li stVi ew_Sort I terns ()) whenever I 
received a LVN_ENDLABELEDIT notification. Granted, that's a little 
dicey, since I'm asking the listview control to sort the items, but 
I have not yet returned from the LVN_ENDLABELEDIT notification, 
which means the listview control does not yet know whether 
I'm going to accept or reject the newly changed text in the item 
the user was editing. I think the listview control designer could 
reasonably have decided either way: either to sort using the old 
value of the text (therefore assuming that I would reject the edit¬ 
ing change) or (more logically, in my 
view) to sort using the new value of the 
text (implicitly assuming that I would 
accept the user's editing changes). 

Unfortunately, I did not consider a 
more daunting possibility: that the 
designer of the listview control would¬ 
n't even have anticipated this situation. 
The sad truth is that if you call 
Li stVi ew_SortItems() when you 
receive an LVN_ENDLABELEDIT notifica¬ 
tion, the listview control will simply 
misbehave. More precisely, if the sort 
causes the items in the control to move 
around, then when you return TRUE 
from the notification, the listview con¬ 
trol will proceed to modify the text of 
the wrong listview item. Apparently, the 
listview control modifies the item at the 
given position, oblivious to the fact that 
the item position could change before 
the notification returns. The listview 
control is not re-entrant even in a sin¬ 
gle-threaded environment, let alone a 
multithreaded one! 

You can use the test program to 
demonstrate this bug. Just click twice 
(once to select, once to edit) the first 
listview item in the control (see Figure 
1). Edit the text and press return. 
Because the test program calls 
Li StVi ew_So rt I terns () when it receives 
the LVN_ENDLABELEDIT notification, the 
listview incorrectly clobbers the last 
string in the control (the one beginning 
with "a") with your edit correction — 
quite a surprise to the user! 

One workaround here is to post your¬ 
self a custom message when you receive 
the LVN_ENDLABELEDIT notification. Then, 
when your window procedure receives 
the custom message, it can go ahead and 
call Li stVi ew_SortItems (). It's not an 
ideal solution, but it does at least help 
you avoid this particular fragility in 
Microsoft's code. 
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The Hit-Testing Problem 

Reasonable people may disagree on what constitutes a 
bug, as opposed to a design flaw or some other, less pejora¬ 
tive, term. In my personal taxonomy, if code behaves such that 
the user can't understand it or can't get some obvious task 
accomplished, I label it a bug whether the designer intended it 
to work that way or not. That's exactly the kind of bug I'm 
going to describe next. 

A listview control in report mode looks a lot like a database 
table. It also looks like something the user ought to be able to 
edit. In fact, though, the designer decided to only allow the 
user to edit the first column of this table (though I personally 
classify that behavior as a bug, that's not the one I want to talk 
about here). Once you and your users accept the fact that only 
the first column is editable, you will run into a very irritating 
behavior: to edit the first column of any item, you have to first 
click on the text. Notice that I said you have to click "on the 
text." I mean that it is not enough to click inside the bound¬ 
aries of the column — you must click over the text itself. If 
your mouse hits a few pixels to the right of the last character in 
the text, it gets ignored. Since the text length may vary from 
one item to another, that means that a click in a certain x posi¬ 
tion will work in one item but be ignored in another item that 
has shorter text. You don't need a million-dollar user interface 
testing laboratory to figure out that this behavior is not a ser¬ 
vice to the user. Fortunately, Microsoft does supply enough 
primitives that you can change it. 

When the user clicks in the listview control, the control 


sends a WM_N0TI FY to its parent, with a notification of NM_CLICK. 
You can then get the current mouse position (by calling 
GetCursorPos ()) and use that information to calculate where the 
click occurred and what action, if any, you want to take. The 


Figure 2 Code to alter click behavior in 
listview 


case WM NOTIFY : 

{ 

NMHDR ‘Head - (NMHDR*)1Pa ram; 

HWND Win * Head->hwndFrom; 

if(Head->code — NM_CLICK) 

{ 

POINT Mouse; 

GetCursorPos(&Mouse); 

ScreenToClient(Win, Mouse); 

LV_HITTESTINFO HitTest; 

HitTest.pt - Mouse; 

ListView_HitTest(Win, &HitTest); 

int Width - ListView_GetColumnWidth(Win, 0); 

// if outside of item text but in first column 
iff!(HitTest.flags & LVHTJNITEM) 

M HitTest.pt.x <- Width) 

{ 

// force the hit to work if on a valid line 
HitTest.pt.x - 1; 

ListView_HitTest(Win. &HitTest); 
iftHitTest.flags & LVHT_0NITEM) 

ListView_SetItemStatetWin, HitTest.iItem, 
LVI$_F0CUSED|LVIS_SELECTED, 
LVIS_F0CUSED j LVIS_SELECTED); 



/* End of File */ 
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listview macro Li StVi ew_HitTest( ) can 
help — given a mouse position, it can 
tell which listview item the mouse is 
over (if any) and supply some informa¬ 
tion about where on the item the hit 
occurred. 

In my case, I wanted a click any¬ 
where inside the first column to behave 
the same as clicking over the text in the 
first column. Figure 2 shows the code 
fragment I used to do the trick. 
Li StV i ew_HitTest () fills in a structure 
with information, and its flags member 
has the LVHT_0NITEM bit set if the posi¬ 
tion lies over the text of a valid item in 
the listview control. If that's the case, I 
can just let the normal listview behavior 
alone, since it will select the item. If not, 
then I have to do some further calcula¬ 
tion to see if the hit was over some other 
area of the item. 

Amazingly, after going to all the 
trouble to provide hit-testing function¬ 
ality, the author of the listview control 
did not bother to calculate which col¬ 
umn the hit occurs in, so you have to do 
this yourself by adding up column 
widths. In this case, I only wanted to 
intercept hits in the first column, so I 
check to see if the x position of the 
mouse is less than the width of the first 
column. However, I still have to make 
sure the y position is over a valid item, 
so I call ListView_HitTest() again with 
an x position (1) that is guaranteed to lie 
over the item text, if there is an item 
there at all. You can use this technique 
to figure out which column in which 
item the mouse is over. Once I've isolat¬ 
ed the case I care about, I just call 
ListView_SetItemState( ) to select the 
clicked-on item. 

Undocumented Edit 
Notifications 

The listview control exposed some 
bugs in my own code. When I write a 
dialog procedure, I always start with 
some boilerplate code that includes the 
following lines in my WM_COMMAND han¬ 
dler: 

if(ControlId==ID0K||Control Id—IDCANCEL) 

{ 

EndDialog(Dialog, Control Id); 

return TRUE; 

1 

In fact, this is pretty sloppy code, 
because I do not check the notification 


code. I happen to "know" that the only 
notification a button command ever 
sends is BN_CLICKED, so I never bother to 
check it. This code has worked happily 
on many projects for a long time, but it 
still violates an important principle: you 
should always ignore any messages or 
notifications that you do not recognize. 
Looking through the published litera¬ 
ture, I can see I'm not the only one who 
has been lazy about checking notifica¬ 
tion codes for these buttons. 

Sure enough, the listview control 
located this flaw in my code for me, due 
to an "interesting" part of its design. 
When I started to edit an item in the 
listview control, as soon as I pressed a 
key my dialog disappeared! This was 
indeed mysterious, and I did a lot of 
head scratching before I finally realized 
that somebody was generating a notifi¬ 
cation for either my IDOK button or my 
IDCANCEL button. Further inspection 
revealed that the notification code was 
either 0x0300 or 0x0400. That's when the 
awful truth hit me. 

When you edit a listview item, the 
listview control secretly creates its own 
edit control, positioned above the item 
being edited. Apparently, the listview 
control designer decided it would be 
nice to pass that edit control's notifica¬ 
tion messages on to the parent dialog. 
All well and good, but what control ID 
should be associated with those notifi¬ 
cations? In a better world, the designer 
might have allocated a new reserved 
control ID (e.g., I D_L I STV IEW ED IT), 
adding to the existing reserved IDs 
such as I DOK and IDCANCEL. Instead, the 
designer decided just to use I DOK for 
the control ID of the edit control. After 
all, the edit control notifications, such 
as EN.CHANGE (0x0300) and ENJPDATE 
(0x0400), happen to lie numerically 
above any possible button notifications. 

Like so many aspects of the Windows 
API, this feature of the listview control is 
not documented. That could indicate 
Microsoft does not want to guarantee 
support for the feature in future ver¬ 
sions, or it could just be a symptom of 
the generally incomplete documenta¬ 
tion. Either way, be aware that notifica¬ 
tions from unrelated controls may be 
stacked upon your I DOK button — notifi¬ 
cations aren't really guaranteed by the 
documentation to be there in future ver¬ 
sions of the listview control. 
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And a Borland Bug for Free 

I wanted to make the code for the test 
program work with both Microsoft and 
Borland compilers. Unfortunately, the 
latest version of the Borland compiler 
(5.0) still contains a bug I first reported in 
the March Readers' Forum, and that bug 
not only keeps the test program from 
working, but may give you fits if you 
attempt to use Borland C++ to develop 
dialogs containing the new common 
controls. To quickly summarize the 
problem, consider the following . rc file: 

#include "windows.h" 

#include "commctrl.h" 

#ifndef .WIN32 

((error "This is very bad!" 

ifendif 

If you attempt to compile this resource 
file by typing: 

brc32 -r test.rc 

you get the error message "This is very 
bad." Why is it bad that .WIN32 is not 
defined? Because commctrl .h uses that 
symbol to decide whether it is dealing 
with 16-bit code or 32-bit code. In par¬ 
ticular, if you have a dialog that defines 
a listview control like this: 

CONTROL "", 104 ,WC.LI STV IEW , \ 

WS.B0R0ER | 0x201,29,64,164,58 

then Borland's resource compiler will 
incorrectly create a control class name of 
"SysListView" instead of 

"SysListView32", and the resulting dia¬ 
log will die a horrible and mysterious 
death. 

Klaus Krull of Borland points out that 
this bug does not occur if you use their 
IDE tools to generate the . rc file. He sug¬ 
gests avoiding the bug and speeding up 
resource compilation with the following 
construct: 

tflf !defined(W0RKSH0P_INV0KED) 

((include <windows.h> 

((include Ccommctrl .h> 
ifendif 

Also, Klaus indicated that Borland 
would fix this problem in a patch to be 
available before May. 

What about NT? 

Windows NT 3.51 also provides 
common controls, so that raises an 
interesting question: did the NT folks 


decide to be bug-for-bug compatible 
with Windows 95? It turns out that they 
did, as running the test program under 
NT 3.51 produces the same problems as 
under Windows 95.1 have not checked 
the beta of NT 4.0 to see if it will remain 
the same or not. 

Summary 

Microsoft's listbox control is full of 
bugs and amateurish design mistakes, 
but it has the irresistible quality of 
already being installed on millions of 


machines. That means it is usually more 
efficient to work around the flawed 
Microsoft code than to try to replace it 
with your own. To its credit, the 
listview control is flexibile enough that 
you can correct most of its worst prob¬ 
lems. On the other hand, the new tree- 
view control... is a subject for another 
article. □ 
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Oberon Software, Inc.’s TE/2™ 
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PSSoftware’s RIMS 
RFF Electronics’ RFFlow 
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Add Icons and Bitmaps to Buttons the Easy Way 


Paula Tomlinson 
paulat@microsoft.com 

With so many new controls available now on Windows 95 and Windows NT, it's 
easy to overlook an important new message for the Button control. In order to have 
a bitmap or icon appear on the face of a button, it used to have to either subclass it 
or use an ownerdraw button. In either case, creating the effect of the pressed and 
unpressed states (as well as the disabled state) took a fair amount of painstaking 
code. Now it's easy! 

There's a new message, BM_SETIMAGE, that you can send to a button to cause it to 
display an icon or bitmap centered on its face. The Win32 online help file does not 
document this new feature correctly. For instance, the version of online help I'm 
using fails to point out that you need to also specify a new button style, BS_ICON or 
BS_B ITMAP, for any button that you plan to send this message to. 

PUSHBUTTON ID_ICONBUTTON, 10,10,12,12, 

WS_GR0UP | BSJCON 

PUSHBUTTON ID_BITMAPBUTTON, 10,24,12,12, 

WSJ3R0UP | BSJITMAP 

If the button has the appropriate style, then during WM_INITDIALOG processing you 
can simply send the button a BM_SETIMAGE message. Again, the online reference 
claims that wParam is not used and must be zero. In fact, you must specify either 
I MAGE_I CON or IMAGE_B I TMAP. I MAGE_B ITMAP happens to be defined as zero, so you 
might not run into this problem unless you try using an icon. 

case WMJNITDIALOG: 

SendDlgltemMessaget hDlg, ID_IC0NBUTT0N, 

BMJETIMAGE, (WPARAM)IMAGE_ICON. 

(LPARAM)Loadlcon(hlnst, MAKEINTRESOURCEtIC0N_X))); 

SendDlgltemMessagefhDlg, ID_BITMAPBUTTON, 

BM.SETIMAGE, (WPARAM)IMAGE_BITMAP, 

(LPARAM)LoadBitmap(hlnst, MAKEINTRESOURCEtBITMAP_Y))); 

The button will take care of drawing the borders and the visual effects of being pressed 
and released as usual. Since color schemes can change so easily under Windows 95,1 
prefer sticking to icons (rather than bitmaps) and having the background of the icon 



Leor Zolman is a consultant specializing in C/C++ programming training, an instructor 
on UNIX topics for Boston University's Center for Information Technology, and "Tech 
Tips" editor for Windows Developer's Journal. His book, Illustrated C, was published 
in 1992. He may be contacted at 74 Marblehead St., North Reading, MA 01864. Internet 
address: leor@bdsoft.com. 


June 1996 


Windows Developer’s Journal — Page 25 




















be transparent (screen color). Then if a user changes the but¬ 
ton face color, my icon will still look fine. 

Finally, the BM_GETIMAGE message returns a handle to any 
bitmap or icon that is currently being used to paint the button. 
Rather than hang on to a global hlcon or hBi tmap variable, you 
can use this message to retrieve and free the resource, if neces¬ 
sary, before destroying the window or dialog box. 



Toolbar Hint Tags in ObjectWindows 2.5 


Brent W. York 
SAGE Enterprises 
sage@ameritel.net 


Figure 1 hintbar code fragment 


#include "hintbar.h" 


TControlBar *myApp::CreateToolBar(void) 

( 

THintTagBar *bar - new THintTagBartframe, TGadgetWindow: horizontal, 
new TGadgetWindowFont(6, true, false)); 
bar->Insert(*new THintButtonGadgetiBMP1, CM_CMD1, 

"Command One"); 

bar->Insert(*new THintButtonGadgettBMP2. CM_CMD2, 

"Command Two"); 

bar->Insert(*new THintButtonGadget(BMP3. CM_CMD3. 

"Command Three"); 

bar->Insert(‘new TSeparatorGadget(8)); 
bar->lnsert(*new THintButtonGadgettCMJXIT, CM.EXIT, "Exit")); 
bar->SetHintMode(TGadgetWindow::EnterHints); 
bar->Attr.Id - IDW_T00LBAR; 

bar->SetTagDelay(1000); // set delay in milliseconds 
return bar; 


n n 
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No royalties Source code available visa/mc/cod. 

o Request Reader Service #125 o 
Page 26 — Windows Developer’s Journal 




One of those little touches that can make one application 
stand out from the others is the ability to display hint tags 
when the cursor flies over controls in a toolbar. The various 
Microsoft Office applications provide good examples of this 
effect. If the user places the cursor over a toolbar control and 
leaves it for a short period of time, a "cue card" or "hint tag" 
appears with a short description of what the control does. As 
the user then moves on to other controls, the hint tags pop up 
without delay, until the cursor is moved off the toolbar. This 
functionality can be added to the TControl Bar class in 
Borland's ObjectWindows 2.5 with only a little extra code. 


Figure 2 TlnputDialog class 


n . 

// myinpdia.h 

// Definition of TMylnputDialog class 

// . . 

#if !defined(MY INPUTDIA_H) #define MYINPUTDIAJi 

##include fowl/inputdia.h> 

class TValidator; 

II 

II class TMylnputDialog 
// . 

// class TMylnputDialog : public TlnputDialog { 
public; 


TMylnputDialog(TWi ndow* parent, 

const char far* title, 
const char far* prompt, 
char far* buffer, 
int bufferSize, 

TModule* module - 0, 

TValidator* validator - 0); 

); jfendif II MYINPUTDIAJi 


and in the constructor do the following:- 

//. 

// 

// Implementation of TMylnputDialog. User string input 
// dialog box 

//. 

#i nclude <owl/owl pch.h> 

#include "myinpdia.h” 

#include <owl/edit.h> 


TMylnputDialog::TMyInputD1alog(TWindow* parent, 

const char far* title, 
const char far* prompt, 
char far* buffer, 
int bufferSize, 

TModule* module, 
TValidator* validator) ; 


TlnputDialog!parent, title, 
prompt, buffer. bufferSize, 
module,0) ( 

if (validator) 

new TEdit(this.IDJNPUT,bufferSize)->SetValidator(validator); ) 
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Listing 1 hintbar.h 


II hintbar.fi -- Class definitions for hint tag control bar 

TTi1eDirecti on direction - Horizontal, 

// classes. 

TFont ‘font - new TGadgetWindowFont, 

//include <owl\buttonga.h> 

TColor textColor - TColor::B1ack. 

TColor borderColor - TColor::B1 ack. 

//include fowl\controlb.h> 

TColor brushColor - TColor(255.255,115), 

//. 

TModule *module = 0); 

~THintTagBar(void); 

II--- THintButtonGadget Definition 
//. . 

class THintButtonGadget : public TButtonGadget 

bool IdleActiondong idleCount); 

TColor GetTextColor(void) { return colorTag; } 

TPen *GetBorderPen(void) { return penTag; } 

t 

TBrush ‘GetBackgroundBrush(void) { return brushTag; } 

public: 


THintButtonGadgettTResId bmpResId, int id. 

void SetTagDelay(int delay) ( delayTag - delay; } 

char far *tag - 0, // hint tag displayed if 

void CreateTagCconst char far ‘text); 

// mouse lingers 

void DestroyTag(void); 

TType type - Command, bool enabled - false, 

TPoint SGetLastPoint(void) { return lastPoint; } 

TState state - Up, bool repeat - false); 


~THintButtonGadget(void); 

protected: 

protected: 

TWindow *tag; 
int delayTag: 

char far ‘text; 

TPoint lastPoint; 

void MouseEnter(uint modKeys, TPoint& p); 

bool tagsActive; 

TColor colorTag: 

void MouseLeavefuint modKeys, TPointS p); 

TPen *penTag; 

}; 

TBrush *brushTag; 

//. . 

void EvLButtonDown(uint modKeys, TPoint& point); 
void EvMouseMove(uint modKeys, TPoint& point); 

II--- THintTagBar Definition 

void EvTimer(uint timerld): 

//. 

void ShutDownTags(void); 

class THintTagBar ; public TControlBar 

DECLARE RESPONSE TABLECTHintTagBar); 

{ 

DECLARE CASTABLE; 

public; 

1; 

THintTagBar(TWindow ‘parent - 0, 

// End of File 
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Listing 2 hintbar.cpp 


// hintbar.cpp •• Member function definitions for hint tag 
// control bar classes. 


ifinclude "hintbar.h” 
// Required Constants 


const int SPACE - 4: 

const int 0FFSET_X - 5; 

const int 0FFSET_Y - 20; 

const int TIMER_ID - 1; 


// space around text in hint tags 
// horizontal offset of hint tag 
// from cursor 

// vertical offset of hint tag from 
// cursor 

// ID of timer used for hint tag 
// appearance delay 


//. 

//-■- THintButtonGadget Implementation 

//. . . 

THintButtonGadget::THintButtonGadgetCTResId bmpResId, int id, 

char far ‘tag, TType type, 
bool enabled, TState state, 
bool repeat) : 

TButtonGadgettbmpResId, id, type, enabled, state, repeat) 

( 

text - 0; 
if (tag) { 

text - new char[strlen(tag)+l]; 
strcpyttext, tag); 

) 

1 

THintButtonGadget::—THintButtonGadget(void) 

( 

delete text; 

) 
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void THintButtonGadget::MouseEnter(uint modKeys, TPointS pt) 

{ 

TButtonGadget::MouseEnter(modKeys, pt); 

TYPESAFE_DOWNCAST(Window, THintTagBar)->CreateTag(text); 


void THintButtonGadget::MouseLeave(uint modKeys, TPoinU pt) 
{ 

TButtonGadget::MouseLeave(modKeys, pt); 

TYPESAFE_DOWNCAST(Window, THintTagBar)->DestroyTag(); 


//. 

II--- TTagWindow Definition 

//. 

class TTagWindow : public TWindow 

( 

public: 

TTagWindow(TWindow ‘parent, const char far* title); 
virtual bool Create(void); 

virtual void Paint(TDC& dc, bool erase, TRectS rect); 

); 


//--. 

II--- TTagWindow Implementation 

II--- . . . 

TTagWindow::TTagWindow (TWindow ‘parent, const char far* title) 
: TWindowtparent, title) 

{ 

Attr.Style - WS_POPUP | WS_DISABLED; // invisible window 


bool TTagWindow::Create(void) 

{ 

bool result; 

TPoint point - TYPESAFE_DOWNCAST 

(Parent, THintTagBar)->GetLastPoint(); 

TRect r - Parent->GetWindowRect(); 

Attr.X - point.x + r.left + OFFSET_X; 

Attr.Y - point.y + r.top + OFFSET_Y; 

Attr.W - 1; // to be calculated at Paint time 

Attr.H - 1; 

result - TWindow::Create(); 

Show(SW_SHOWNOACTIVATE); // make visible without changing 

// active 

return result; 


void TTagWindow::Paint(TDC& dc, bool erase, TRectS rect) 

{ 

TWindow::Paint(dc, erase, rect); 

TRect r; 

TSize sz: 

THintTagBar ‘owner - TYPE$AFE_DOWNCA$T(Parent, THintTagBar): 

dc.SelectObject(owner->GetFont()); 

sz - dc.GetTextExtentITitle, strlen(Title)); 

Attr.W - sz.cx + SPACE; 

Attr.H - sz.cy + SPACE: 

MoveWindowtAttr.X, Attr.Y, Attr.W, Attr.H, true); 
dc.SelectObject(*(owner->GetBackgroundBrush())); 
dc. SelectObject(*(owner->GetBorderPen())); 
r - TRect(0, 0, Attr.W, Attr.H); 
dc.Rectangle(r); 

dc. SetTextCol or (owner- >GetTextCol or ()); 
dc. SetBkMode(TRANSPARENT); 

dc.DrawText(Titie, -1, r, DT.CENTER | DTJ/CENTER | DTJOCLIP | 
DT_EXTERNALLEADING | DT.SINGLELINE); 
dc.RestoreObjectsO; 

) 


//. 

II--- THintTagBar Implementation 

II . 

DEFINE_RESP0NSE_TABLE1(THintTagBar, TControlBar) 
EV_WM_LBUTTONDOWN, 
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Listing 1 (hintbar.h) contains class definitions for 
THintTagBar and THintButtonGadget, representing "hint tag 
aware" control bars and button gadgets. To build a standard 
toolbar under ObjectWindows, you create an instance of 
TControlBar and populate it with TGadgets. To build a toolbar 
with hint tag capability, you create a THintTagBar instead, stuff¬ 
ing it with "hint tag aware" gadgets like THi ntButtonGadget. 
Adding this functionality to an existing program is easy, since 
you need only change the creation of the toolbar and the gad¬ 
gets; no other alterations to the program are required. 

Listing 2 (hintbar.cpp) contains the implementation of 
THi ntTagBar and THi ntButtonGadget, as well as the definition of 
TTagWindow, representing the hint tags themselves. 
THi ntTagBar 's constructor is like that ofTControlBar, but with a 
few extra arguments to define the color scheme of the hint tags. 
SetTagDelay is the only member function of THintTagBar that 
most applications will ever need to call; it is used to set how 
long in milliseconds the cursor must remain motionless in the 
toolbar before hint tags are displayed. If this delay is set to zero 
or less, hint tags are disabled. As far as the calling program is 
concerned, a THi ntButtonGadget differs from a TButtonGadget 
only in how the object is constructed; THi ntButtonGadget adds 
an extra argument to TButtonGadget 's constructor, representing 
the text to be displayed in the gadget's hint tag. 

Though only TButtonGadget is extended here to include hint 
tags, modification of the other standard gadget types is 
straightforward. Each new "hint tag aware" gadget class must 


Listing 2 continued 


EVJMJtOUSEMOVE, 

EV_WM_TIMER, 

END_RESPONSE_TABLE; 

THintTagBar::THintTagBar(TWindow ‘parent, 

TTi1eDirecti on direction, TFont ‘font, 
TColor textColor, TColor borderColor, 
TColor brushColor, TModule ‘module) : 
TControlBartparent, direction, font, 
module), 

1 astPoint(0,0) 

{ 

tag - 0; 

delayTag - 0; 

tagsActive - false; 

colorTag - textColor; 

penTag - new TPen(borderColor); 

brushTag - new TBrush(brushColor); 


THintTagBar::~THintTagBarivoid) 
{ 

DestroyTagO; 
delete penTag; 
delete brushTag; 


bool THintTagBar::IdleAction( 1 ong idleCount) 

{ 

if (idleCount -- 0) { 

// If the mouse is no longer inside the control bar, turn off 
// hint tags 
TPoint pt; 

GetCursorPos(pt); 

if (!GetWindowRectC).Contains(pt)) ShutDownTagsO; 

} 
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add a new argument to the constructor (the text to be dis¬ 
played in its hint tag). Further, the member functions 
MouseEnter( ) and MouseLeave( ) must be overridden to notify 


the parent THintTagBar to create a new TTagWindow when the 
cursor enters the gadget and to destroy it when the cursor 
leaves. 


Listing 2 continued 

return TControlBar: rldleActlonddleCount ) ; 

if (timerld — TIMER ID) ( // ensure this is the timer we expected 

) 

KillTimertTIMER ID); 


tagsActive - true; 

void THintTagBar::EvLButtonDown ( ulnt modKeys, TPointS point) 

if (tag) tag->Create(); // show tag for gadget the user 

{ 

// lingered on 

// Left button down anywhere in control bar turns off hints 

i 

ShutDownTagsO; 

i 

TControlBar::EvLButtonDown(modKeys, point); 


} 

void THintTagBar::CreateTag(const char far *text) 

void THintTagBar::EvMouseMove(uint modKeys, TPointS point) 

if (delayTag > 0) { // do nothing if hint tags disabled 

t 

DestroyTagO; // there can be only one! 

if (delayTag > 0) { // none of this matters if hint tags 

tag - new TTagWindow(this, text); 

// are disabled 

if (tagsActive) tag->Create( ) : // only show the tag if 

if (point !- lastPoint) { 

// active 

lastPoint - point; 

) 

if (ItagsActive) { // if hints are not yet active 

) 

// then... 


KillTimer(TIMER_ID); // ...stop any timer in 

void THintTagBar::DestroyTag ( void) 

// progress and... 

( 

if (tag) SetTimertTIMERJD, delayTag); 

delete tag; 

} // ...restart if there's a tag 

tag - 0; 

// waiting 

i 

} 

void THintTagBar::ShutDownTags ( void ) 

TControlBar::EvMouseMove(modKeys, point); 

{ 

) 

KillTimertTIMER ID); 


DestroyTagO; 

void THintTagBar::EvTimer ( uint timerld) 

tagsActive - false; 

// Timer has fired -- user calmed down long enough to see the 

} 

// tags! 


( 

//End of File 
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Figure 1 shows a typical code excerpt for setting up a tool¬ 
bar with hint tags. A complete example application is avail¬ 
able electronically (see Table of Contents for availability). 



An OWL 2.5 TInputDialog Bug 


Tony Parsons 
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autofill character and a new NULL, added by the validator, 
which extends one byte past the end of buff. 

The solution is to derive a new class from TInputDialog, as 
illustrated in Figure 2. 

Note that val Tdator is always passed up the hierarchy as 0, 
so that 

1) the base class constructors think that no Validator is 
required, and 

2) the TEdit is created here rather than in the TInputDialog 
constructor, but the buffersize is passed to the TEdit 
properly. □ 


I have found and fixed a bug in the 
OWL 2.5 TInputDialog that causes 
memory trashing when used with a 
TPXPictureVal idator with the autofill 
option enabled. The problem occurs if 
the validator "autofills" any characters 
into the TEdit control owned by the 
TInputDialog. The result is a write past 
the end of a buffer that does not always 
show up immediately but can cause 
hangs and GPFs. 

The problem begins within the 
TInputDialog constructor with the code 

if(validator) 

new TEdittthis, ID_INPUT)-> 

SetValidatortvalidator); 

The size of the input buffer is not passed 
to the TEdit, so the value of TextLen in 
the TStatic class from which TEdit is 
derived defaults to 0. 

In the TEdit: : EvCha r() function, 
each character that is input is passed to 
the control via a call to 
TStatiC::EvChar( ). Before calling the 
validator's Is Val id Input () function for 
each character entered, the text that has 
already been entered and stored in the 
control's buffer is locked into a new 
local buffer (char far * buff), the 
length of which should be determined 
by TextLen, so that any characters aut- 
ofilled by the TPXPictureVal idator can 
be accommodated. However, as TextLen 
is 0, the length of the buffer is just 
enough to hold the current text plus the 
NULL terminator. The following TEdit 
code explains this. 

char far * buff = 

LockBuffer(max((int)TextLen, 
max(oldBuffLen, 
buffLen))+l); 

If the TPXPictureVal idator autofills 
with even one character, the NULL ter¬ 
minator of buff is overwritten with the 
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Port I/O under Windows 

Karen Hazzah 


If your Windows application must interact with some custom hardware, the con¬ 
ventional wisdom says "You need to a write a device driver," words which strike 
fear in the hearts of many developers. In most cases, the conventional wisdom is 
right, and you'll have to bite the bullet and write a device driver. In fact, you may 
have to write more than one, as Windows NT uses a completely different driver 
model than Windows 3.x and Win95. 

However, in some cases, a separate driver isn't strictly necessary. If the only hard¬ 
ware support you need is a few I Ns and OUTs to an I/O-mapped device and you're 
supporting only Windows 3.x and 95 (not NT), you can actually perform the port I/O 
directly from your application or DLL. This article will tell you when this is appropri¬ 
ate, how to do it (that's actually the easy part), what kind of performance you can 
expect, and why this technique actually works. First, I will review how the hardware 
and software work together to define how port I/O works under Windows. 

Hardware Review 

The Intel 80x86 architecture provides a separate range of addresses (64Kb worth) 
for port I/O, accessible via special instructions such as IN and OUT. On the 8086, access 
to I/O ports is available to any code at any time. Beginning with the 80286, however, 
the Intel 80x86 architecture offers several protection mechanisms that allow an operat¬ 
ing system to be robust and guard against crashes. Central to these mechanisms is the 
idea of privilege. In Intel jargon, the highest privilege is ring 0, with rings 1, 2, and 3 
having decreasing privilege. Code running at ring 0 — the operating system itself and 
device drivers — is allowed to access any memory location or I/O port and execute 
any instruction. The operating system then runs application code at a less privileged 
level (ring 1,2, or 3), where accessing certain memory and I/O locations, or executing 
certain instructions, causes an exception. An exception transfers control back to the 
operating system, which can decide on an appropriate action. 

To control access to I/O ports, the 80286 added an I/O privilege level field to the 
FLAGS register. This I/O privilege level basically specifies that a GP fault will occur if 
the application attempts to execute an IN or OUT instruction while running in a less 
privileged ring. For example, if the operating system sets the I/O privilege level for 
a specific application to 0, that means it can only perform I Ns and OUTs when running 
in ring 0 (the most privileged level). If an application running in a ring less privi¬ 
leged than its I/O privilege level attempts I/O, the operating system could decide to 
handle the resulting general protection exception by performing the I/O on behalf of 
the less privileged code. Obviously, that involves significantly more overhead than 
did just performing an IN or OUT on an 8086. 

The 80386 provides finer-grained protection of I/O — it allows an operating system 
to control precisely which I/O ports an individual application can access. Each 80386 
protected-mode application has a bitmap associated with it, where each bit corre¬ 
sponds to an I/O port address. When the application attempts an I/O operation, the 
hardware first checks the I/O privilege level (as with the 80286), but if the application 
fails that test (is running at a less privileged level than the 1/O privilege level), then the 
80386 additionally checks to see that the corresponding I/O bitmap bit for the applica¬ 
tion is zero. If so, then the application has permission to access that port; otherwise, a 
general protection exception is raised. With the 80386, an operating system can choose 
to grant access to all ports by setting the I/O privilege level appropriately, or it can 


Karen Hazzah is a software engineer with experience in writing Windows, DOS, and 
OS/2 device drivers. She is the author of Writing Windows VxDs and Device Drivers, 


ISBN 0-13-100181-7. 


Windows Developer’s Journal — Page 33 























Get the Software Development 
Training You Need 

directly from the experts! 


Intensive Regional Training Seminars are coming your way 
on some of the hottest topics in the development industry— 
taught by the experts! 


Coming 
this year to: 

Boston 
Chicago 
Dallas 
Denver 
New York 
Seattle 
Toronto 

Washington, D.C. 
and many more! 

For specific dates and 
locations, call 
(415) 905-2702 


Find out more about these in-depth seminars 
coming to a city near you: 

• C++ Fundamentals 

Dan Saks 

• Windows 95/NT Programming with Visual C++ 4.0 and MFC 4.0 

Richard Hale Shaw 

• Object-Oriented Analysis & Design using the Booch/OMT Unified Method 

Carl Argila 

• User Interface Design and Rapid Visual Development 

Lucy Lockwood and Larry Constantine 

Later this year look for more topics including: 

• Java Programming 

• Designing Client/Server Applications on the Internet 

• Visual Basic Programming 

• Dynamics of Software Development 


Contact us TODAY to become an expert in these 
hot software development topics! 

Phone: Fax: E-Mail: Web Site: 

(415)905-2702 (415)905-2222 sdconfs@mfi.com http://www.mfi.com/sdconfs 


Produced by the Software Development Conference & Show Group of Miller Freeman, Inc. 
600 Harrison Street, San Francisco, CA 94107 

'f/'f. Miller Freeman 

A United New>. & Media company 









grant an application access to only spe¬ 
cific ports by setting bits in the I/O per¬ 
mission bitmap. 

Virtual-86 mode is a slightly different 
case — in that mode, the processor 
ignores the I/O privilege level and relies 
solely on the I/O bitmap to determine 
whether or not to raise an exception. 

Windows 3.1 I/O Trapping 

I/O port protection mechanisms are 
crucial to Windows' ability to safely run 
legacy DOS applications. Using the 
hardware protection facilities, 
Windows can allow a DOS application 
to execute as though it had the machine 
to itself. If the DOS application attempts 
to access a port, Windows can get con¬ 
trol (via an exception) and either allow 
the I/O to proceed or, if some other 
application has already claimed the use 
of that port, display an error message. 
In this section, I will describe how 
Windows 3.x makes use of the hard¬ 
ware to manage port 1/O protection. 

The Windows 3.x multitasking ker¬ 
nel, called the VMM (Virtual Machine 
Manager), runs at ring 0. Each DOS 
application runs in a separate virtual 
machine (VM), and all Windows 3.x 
applications run in a single VM togeth¬ 
er; the VMM handles the multitasking 
of these VMs, among other things. The 
VMM runs Windows applications at 
ring 3 with an I/O privilege level of 0. 
This means that when your application 
attempts to execute an IN or OUT instruc¬ 
tion, it will be running at a less privi¬ 
leged level (level 3) than its I/O privi¬ 
lege level (level 0), so the hardware will 
consult the I/O permissions bitmap to 
see if your task has permission to use 
the specific port you are attempting to 
access. The VMM initializes the I/O per¬ 
missions bitmap to zeros so that all port 
addresses are accessible, but individual 
virtual device drivers (VxDs) may turn 
on bits to trap individual ports. 

VxDs can be used for many other 
purposes, but the VxDs I'll be talking 
about here exist to virtualize a specific 
hardware device, giving each applica¬ 
tion the illusion that it has exclusive 
control over devices such as the timer 
chip, the DMA controller, etc. Windows 
3.x contains a VxD for many standard 
PC devices, such as the interrupt con¬ 
troller, keyboard, timer, and many more. 
When these VxDs initialize, each calls 


the VMM service Instal l_I0_Handl er to 
register a port trap handler for each port 
on its 1/O-mapped device. 

The VMM service 

Instal l_I0_Handl er sets the port's bit in 
the I/O permissions bitmap so that 
access to the registered port will cause an 
exception. It also sets a software flag to 
indicate that this port is to be trapped for 
all virtual machines (global trapping). 
Last, Install_IO_Handler stores away 
the address of the port trap handler. 
Later, when a VM accesses the registered 
port and the exception occurs, the VMM 
calls the specified port trap handler. So 
although the I/O permissions bitmap 
starts out with all zeros so that nothing is 
trapped, it ends up containing lots of 
ones as different VxDs load and register 
port trap handlers for their devices. 

If your Windows 3.x app does an IN 
or OUT to a port that no VxD has trapped, 
no exception results and the access goes 
straight through to the device. However, 
if a VxD has trapped the port, all bets 
are off. A VxD's port trap handler can 
take one of the following actions when it 
traps your port I/O request: ignore the 
request, emulate it, disable further trap¬ 
ping, or execute the request. 

A case where a VxD ignores a port 
I/O request is the Virtual Timer Device 
(VTD), which is responsible for virtualiz¬ 
ing the 8254 hardware timer chip. The 
VTD blocks any attempt by an applica¬ 
tion to speed up the timer frequency. 
After all, a dependable periodic timer 
tick is the heart of the VMM's multitask¬ 
ing scheduler, so preventing an applica¬ 
tion from speeding up the timer is impor¬ 
tant. The VTD's port trap handler accom¬ 
plishes this by always ignoring write 
accesses to the timer's count register. 

An example of a VxD emulating a 
port I/O request is the Virtual Comm 
Device (VCD), responsible for virtualiz¬ 
ing all serial ports. The VCD does a 
great deal of work in its port trap han¬ 
dlers to emulate the real serial port. The 
VCD keeps a "virtual" copy of each of 
the serial port registers. These virtual 
registers are initialized to the real port's 
reset values. Write accesses to most ser¬ 
ial port registers do not go through to 
the actual hardware, but are instead 
stored in the virtual register. Read 
accesses are handled by returning to the 
VMM the value stored in the virtual 
register, not the actual register, and the 
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VMM takes care of putting this value into the AL/AX/EAX regis¬ 
ter when control returns to the application. 

Another common action in a port trap handler is to disable 
port trapping for a specific VM, but leave it enabled for other 
VMs. This is useful because many VxDs implement a "you 
touch it, you own it" policy for their device — that is, the VxD 
watches for access to its device by all VMs, but once a particu¬ 
lar VM has accessed the port, the VxD wants that VM to have 
unrestricted access. However, the VxD still needs to watch for 
access by other VMs, in order to prevent two VMs from 
accessing the device at the same time. 

To accomplish this, the VxD calls the VMM service 


Di sable_Local_Trapping, passing as parameters the port and 
the VM handle. Calling this service doesn't affect the 1/O per¬ 
missions bitmap, only the "global trapping" flag set earlier by 
Instal l_I0_Handl er. Because the I/O permissions bitmap bit 
is still set, access by any VM still causes an exception. But 
before calling the registered port trap handler, the VMM first 
checks the "global trapping" flag. If it's clear, the VMM does a 
further check against a list of all VM handles passed in to 
D i sabl e_ Local _T rapping. If a match is found, the VMM does 
not call the registered handler, but instead executes the 1/O 
instruction. The device's associated VxD thus remains igno¬ 
rant of the access. 


A VxD to Trap Port Trapping 


The information in Table 2, showing which VxDs trap 
which ports, was obtained by two different methods. The 
TRAPLIST VxD discussed here takes advantage of IFSMGR 
services which are available only under Windows 3.1. I 
found a program, 10 PM. EXE, in the Microsoft 
Knowledgebase, which extracts the list of trapped I/O ports 
from the IOPM itself. But the names of the VxDs that did the 
trapping are actually educated guesses based on my experi¬ 
ence with and knowledge of Windows 3.1. 

TRAPLIST creates a file called vxdtraps.lst in the \win- 
dows\system directory that shows each I/O port address 
trapped by a VxD and the name of the VxD that trapped it. 
TRAPLIST is a very simple VxD, using only four VMM ser¬ 
vices and processing only three VxD messages. The source 
code is available on the code disk, along with the VxD itself 
(see Table of Contents for availability). 

Hooking Install__IO_Handler 

The first message processed by TRAPLIST is 
Sys_Critical_Init, which marks the first phase of Windows 
initialization. At this time, TRAPLIST hooks the VMM 
Instal 1_I0_Handl er service by calling GetVxDServi ceOrdinal 
to obtain a numeric code corresponding to the VMM service 
to be trapped (Instal 1 _10_Hand 1 er) and then passing that 
code to the Hook_Device_Service. Hook_Device_Service 
returns the address of the previous hook procedure in ESI, 
and TRAPLIST stores this address for later use by the hook 
procedure. After the hook is installed, whenever a VxD traps 
an I/O port by calling Install_I0_handler, TRAPLIST will 
be called back. In this callback, TRAPLIST will record infor¬ 
mation about the VxD that called Instal l_I0_Handl er. 

TRAPLIST's hook procedure is TRAPLISTJlookProc. On 
entry to the hook procedure, all registers contain exactly the 
same values they did on entry to Install_I0_Handler. 
Windows requires hook procedures to restore all these regis¬ 
ter values on exit, so TRAPLIST_HookProc first pushes all regis¬ 
ters onto the stack. Next, T RA P LIST_H o o k P r0 c checks the num¬ 
ber of port traps already recorded, to make sure it has room 
to record information on one more. If so, the code gets the 
port being trapped from EDX and the address of the port trap 
handler from ES I (both values put there by the VxD that actu¬ 
ally called Instal l_I0_Handl er), and stores them in a table. 
Last, the hook procedure bumps the number of port traps 


recorded, pops the stack to restore all initial register values, 
and then jumps to the hook procedure that was stored earlier. 

TRAPLIST processes the stored port trap information 
during the Init_Complete message. This is the appropriate 
time because VxDs aren't allowed to call Instal 1_10_Handl er 
after initialization. TRAPLIST_Init_CompI ete transforms the 
table of 1/O port addresses and port trap handler addresses 
into a file containing port addresses and VxD names. 

VxD Names from Addresses 

TRAPLIST transforms the address of a port trap handler 
function, stored in a table by TRAPLIST_HookProc, into a VxD 
name by calling the VMM service _GetVxDName. _GetVxDName 
takes as input the address of either a VxD function or a VxD 
variable, and returns as output the name of the VxD, as a 
string. So TRAPLIST provides the address of a VxD func¬ 
tion, specifically, the port trap handler function from the 
table, which the VxD passed to Instal l_I0_Handl er. 

Once TRAPLIST has the VxD name as a string, it converts 
the I/O port address into a string (using its own utility func¬ 
tion, ShortToAscii). Now it has an ASCII string containing the 
VxD name, the I/O port address, and a CR/LF terminator, all 
the data needed to write to the output file, vxdtraps .1st. 

TRAPLIST uses several short functions to perform the file 
I/O: CreateFi 1 e, WriteFile, and CloseFile. Each of these 
functions does nothing more than set up a few registers and 
call a common subfunction, CommonFi 1 e. 

The actual file I/O is accomplished in CommonFi 1 e by call¬ 
ing I F$Mgr_Ri ngO_Fi 1 elO. This is not a VMM service, but a ser¬ 
vice provided by the IFSMGR VxD. IFS stands for Installable 
File System, and IFSMGR basically manages a large number 
of other VxDs that implement file systems and disk drivers. 

The service I FSMGR_Ri ngO_Fi 1 elO allows VxDs (which run 
at ring 0) to perform file I/O. This service always expects a 
function code (Open, Write, etc.) in EAX, and the other regis¬ 
ters vary according to function. Most take a file handle 
(returned by the Open) in EBX. The TRAPLIST functions 
CreateFile, WriteFile, and CloseFile load the appropriate 
function code into EAX and any other parameters (filename, 
handle, buffer pointer, etc.) into their appropriate registers, 
then call CommonFi 1 e. This function assumes all registers are 
set up appropriately, and does nothing but call 
IFSMgr_RingO_Fi 1 elO. □ 
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Though most VxDs don't do this, it's perfectly acceptable 
for a VxD's port trap handler to go ahead and execute the 
faulting IN or OUT instruction on behalf of the application. This 
being the case, why does the VxD even install a handler? Why 
not just keep the 1/O permissions bitmap bit clear, so that the 
IN or OUT will execute without causing an exception in the first 
place? One reason would be if the VxD were interested only in 
monitoring I/O accesses, not virtualizing them. Then its port 
trap handler would merely (for example) bump an access 
count, and then execute the instruction anyway. 

Windows 95 I/O Trapping 

Windows 95 uses the privilege levels just as Windows 3.x 
does, with the VMM running at ring 0 and applications at ring 
3 with an I/O privilege level of 0. So just 
as with 3.x, the 1/O permissions bitmap 
determines whether or not an IN or OUT 


straight through to the real hardware. Further, accesses to the 
same port won't cause an exception either. Because only the 
initial port access causes an exception, performance doesn't 


Table 1 

port I/O 

Timing trapped and non-trapped 

SYSTEM 

App type 

DOS 

Windows 3.1 

Windows 95 

DOS 

1.37us/NA 

1.33 us/7.95 us 

1.35 us/8.01us 

Winl6 

NA 

1.37 us/ 9.10 us 

1.35 us/ 9.03 us 

Win32 

NA 

NA 

1.37 us/ 8.93 us 

VxD 

NA 

1.23 us/NA 

1.23 us/ NA 


by a Windows 95 application to a partic¬ 
ular port will cause an exception. In 
Windows 95, the I/O permissions 
bitmap is initialized in two phases. 
Before VxDs initialize, the VMM sets the 
I/O permissions bitmap to all zeros, 
such that nothing traps. Then the VxDs 
initialize and register port handlers with 
the VMM, resulting in bits in the I/O 
permissions bitmap being turned on. So 
far, this is the same as Windows 3.x. But 
now Windows 95 adds in an extra step. 

After critical system initialization 
completes, the VMM installs its own 
port trap handlers, turning on more bits 
in the I/O permissions bitmap. It does 
this by looking at its internal list of reg¬ 
istered port handlers, and for every 
port that doesn't have a registered han¬ 
dler, the VMM registers its own default 
handler. This results in almost all bits in 
the I/O permissions bitmap being 
turned on. ("Almost" all, because some 
VxDs tell the VMM to disable trapping 
after registering handlers, and the 
VMM leaves these I/O permissions 
bitmap bits off in the second pass.) This 
sounds like bad news: Windows 95 is 
trapping access to I/O ports that 
Windows 3.x lets you freely access. 
However, the truth is stranger than that. 

Suppose your Win95 application 
accesses some custom port. The default 
port trap handler that the Win95 VMM 
installs does two things: it clears the cor¬ 
responding bit in the I/O permissions 
bitmap (so future accesses to this port 
will not be trapped), then it restarts the 
faulting IN or OUT instruction. Since the 
I/O permissions bitmap bit is now clear, 
the restarted instruction doesn't cause 
an exception, and the access goes 
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suffer after that first access. Thus, even 
though the VMM initially traps all port 
I/O, the result is almost the same as in 
Windows 3.x — free access to any port 
that has not been claimed by a VxD. 

You may wonder why Windows 95 
goes to the trouble of installing port 
trap handlers for most ports if the han¬ 
dler just turns around and disables the 
port's bit in the I/O permissions 
bitmap. Frankly, I wonder too, and I 
don't know the answer. I haven't seen 
an explanation for this behavior, and 
this kind of internal VMM behavior is 
unlikely ever to be documented. 

Windows NT I/O Trapping 

Windows NT is designed to be a 
robust operating system and to support 
multiple platforms. NT device drivers 
are very different from VxDs; they are 
generally written in C and can usually 
be portable across all the hardware plat¬ 
forms NT supports (Intel, PowerPC, 
DEC Alpha, etc.). NT requires all hard¬ 
ware access to be done through a ker¬ 
nel-mode device driver. Under NT, a 
Win32 application that breaks this rule 
and executes an IN or OUT instruction 


will be terminated with a Privileged 
Instruction error message. 

Another design goal of NT is to run 
existing Winl6 binaries. In order to do 
this without compromising the rest of 
the system's integrity, NT runs Winl6 
applications in a VDM (Virtual DOS 
Machine). The VDM contains built-in 
support for virtualizing most standard 
PC devices. In addition, the VDM can 
be supplemented by standalone VDDs 
(Virtual Device Drivers). The role of the 
NT VDM and VDDs is similar to the 
role of built-in and standalone VxDs in 
Windows 3.x and Win95. 

A Winl6 application that executes an 
IN or OUT instruction will cause an 
exception, but this exception will be 
transparently handled. If the access is to 
a standard PC device, the handler is the 
VDM. If the access is to a nonstandard 
device, the access may be handled by an 
NT VDD (Virtual Device Driver). In 
both cases, the handler relies on an NT 
kernel-mode driver to actually perform 
the access. Last, if a Winl6 application 
accesses a nonstandard device that 
doesn't have a VDD, the VDM simply 
ignores the access. 


Of course, if you write ring 0 code 
(such as an NT kernel driver), all things 
are possible. In the May 1996 issue of 
Dr. Dobb's Journal, Dale Roberts demon¬ 
strates how to write an NT kernel-mode 
driver that grants an individual NT 
process access to a specific I/O port. 
The technique is highly nonportable 
and relies on undocumented informa¬ 
tion, but could still be useful for tasks 
such as testing port I/O in user mode 
before writing a device driver. 

When Is Direct Port I/O 
Appropriate? 

You should consider adding hard¬ 
ware support directly to your applica¬ 
tion or DLL only if it meets all these 
requirements: 

• The device is I/O-mapped, not mem¬ 
ory-mapped. Accessing memory- 
mapped devices is complicated 
enough under Windows 3.x and 
Windows 95 to warrant a separate 
driver. 

• The device doesn't generate inter¬ 
rupts. Handling interrupts is compli¬ 
cated enough under Windows 3.x and 
Windows 95 to warrant a separate 
driver. 

•The device's I/O address isn't 
trapped by a VxD. Later, I'll show 
how to determine which I/O 
addresses are trapped. 

How Perform Direct Port 
I/O 

To talk to an I/O-mapped device 
from a Windows application or DLL, you 
use the same method as in a DOS appli¬ 
cation. It all boils down to the assembly 
language instructions IN and OUT, but the 
good news is that you can probably do it 
in C. Microsoft's Visual C++, both the 16- 
bit and 32-bit versions, supports the fol¬ 
lowing runtime library functions for use 
by Windows applications (coni o. h is the 
appropriate header file): 

• _i np() for byte-size input 

• _1 n pw () for word-size input 

• _0litp () for byte-size output 

• _outpw() for word-size output 

If you are using VC++ 4.0, here's a 
caveat. These functions aren't included 
in any of the DLL versions of the C run¬ 
time, so link with one of the static ver¬ 
sions (libc.lib or libcmt.lib). This 
behavior is documented in Microsoft's 


Table 2 Which VxDs trap which I/O ports? 

Windows 3.1 

Port Address 

VxD 

Description 

00-0F/C0-DF 

VDMAD 

DMA controller 

20/21/ AO/A1 

VPICD 

programmable interrupt controller 

40/43 

VTD 

timer 

60/64 

VKD 

keyboard 

3F8-3FE / 3E8-3EE /2F8-2FE 

VCD 

com port (COM1/2/3) 

1F0/3F6 

WDCTRL 

hard disk controller (if Western 
Digital compatible) 

3B4/3B5/3BA/3C0-3CF/3D0-3DF 

VDD 

VGA display 

Windows 95 

Port Address 

VxD 

Description 

3F0/3F1/3F2/3F4/3F5/3F7 

VFBACKUP 

floppy controller 

1F0-1F7 

ESDI_506 

hard disk controller 

378/379/37A 

VPD 

printer LPT1 

2F8-2Fe/3F8-3Fe 

SERIAL 

serial port COM1 and COM2 

61 

VSD 

sound 

3B4/3B5/3Ba/3D0-3DF/3C0-3CF 

VDD 

VGA display 

1CE/1CF/2E8/X6EC-EF 

ATI 

miniport display PCI-specific VGA 

AEC-EF / xEEC-EF 



00-0F/C0-DF/81/82/83/87/89/8A/83/87/89/8A 

VDMAD 

DMA controller 

60/64 

VKD 

keyboard 

40/43 

VTD 

timer 

20/21/A0/A1 

VPICD 

programmable interrupt controller 
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KnowledgeBase (DOCERR: Port I/O 
Functions Not Included in DLL Version 
of CRT). 

Performance 

Just how slow is direct port I/O 
under Windows? Table 1 compares 1/O 
port access among different application 
types and environments. There are two 
entries in each table cell, the first for 
access to a port not trapped by any 
VxD, the second for access to the same 
port but with a “trapper" VxD running 
(where the VxD's trap handler did 
nothing but execute the IN). Each of the 
applications executed five successive IN 
instructions. The measurements were 
obtained by hooking up a logic analyz¬ 
er to a 66 MHz 486, measuring in 
microseconds the time in between suc¬ 
cessive I/O read bus cycles. 

The raw numbers aren't important, 
but the relative comparisons are. What 
the table shows is that access to a 
trapped port, by either a Windows 
application or a DOS application run¬ 
ning under Windows, is five to seven 
times slower than the same access 
under plain DOS. This is true for both 
Windows 3.x and Windows 95. 
However, the most important compari¬ 
son is access to untrapped ports. The 
table shows that access to untrapped 
ports is roughly equivalent regardless 
of application type or environment. 

The big news here is that not only 
can a Windows 3.x or Windows 95 
application really talk to an I/O- 
mapped device with IN and OUT instruc¬ 
tions, it can do it as fast as a VxD or as 
an application running under plain 
DOS — as long as the port isn't trapped. 

Which Ports Are Trapped? 

Since direct port access function 
most efficiently with untrapped ports, 
it's important to know which 1/O ports 
are actually trapped by VxDs. I wrote a 
simple VxD to obtain this information 
(for a discussion of the VxD itself, see 
the sidebar). Table 2 also shows the 
ports trapped by VxDs in a default 
Windows 3.x installation. Note that if 
you have third-party VxDs, any one of 
those could also be trapping ports, 
though it's unlikely unless you installed 
the VxD as a driver for a piece of added 
hardware. Table 2 shows the ports 
trapped by VxDs in a default Windows 


95 installation. Again, third-party VxDs 
may trap additional ports. 

Summary 

Direct port I/O can be both conve¬ 
nient and efficient under Windows 3.x 
and Windows 95. If you're working 
with a custom piece of hardware that 
can be manipulated solely via I/O 
ports, then you may be able to com¬ 
pletely avoid writing a device driver for 
that hardware. 
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Titles for computer professionals in search of usable techniques and reusable code. 
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By Keith E. Bugg 


Keith E. Bugg 
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Help Files 




Learn the nuts and 
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Microsoft Windows 
Help Applications. 
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about using WinHelp. 
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Writing DLL Functions for VB4 

Howard Kapustein 

The industry has seen a flood of VBXs, thanks to Microsoft's inclusion of the 
Control Development Kit (CDK) with Visual Basic. While VBX development is the 
better-known use for it, the CDK has another popular purpose: to integrate external 
functions (in DLLs) with Visual Basic applications. When called by Visual Basic, DLL 
functions can call CDK functions to access and manipulate VB data types, especially 
strings, variants, arrays and controls. This provides the best of both worlds: leverag¬ 
ing Visual Basic's strengths while using other tools (C/C++, Pascal, etc.) to improve 
performance or more easily perform tasks that are cumbersome or impossible in 
Visual Basic itself. 

My company has several large VB projects with a significant code base in DLLs 
directly accessible from VB, thanks to the CDK. Even if some of the code could be 
OCXs, there has been no time to redesign it (and change all the VB code to match). 
Nearly all of our CDK use centers on the string and variant functions, all of which 
have equivalent OLE functions, so the migration should have been easy. 
Unfortunately, the VB4 documentation for this process is poorly worded and omits 
several important details. I spent a good chunk of time gleaning hints from the doc¬ 
umentation and extensively investigating and testing the actual behavior. The good 
news: once you understand the few simple rules, it's quite simple to migrate CDK- 
based code to the OLE APIs. 

Visual Basic 3.0 (VB3) is 16-bit only, but Visual Basic 4.0 comes with a 16-bit and 32- 
bit implementation. This article assumes any code you're compiling for Win32 is ANSI, 
not Unicode. However, if you're writing Unicode programs (_U NIC 0D E is defined), by 
all means keep reading, the Unicode/ANSI conversions just won't be necessary. 

String Handling 

Visual Basic can pass strings to DLLs by value (ByVal) or by reference (no key¬ 
word or By Ref in VB4). Strings passed by value act the same in VB3 and VB4; the 
DLL function can just declare its argument to be of type char*, since it will see nor¬ 
mal C-style, null-terminated strings. Though the result is the same for the called DLL 
function, the internal mechanics of strings passed by value are different between 
VB3 and VB4. VB3 converts its internal string representation (HLSTR: basically, a han¬ 
dle that refers to a two-byte count followed by the string data) to a null-terminated 
string. VB4 internally stores strings as OLE strings (a character count followed by 
Unicode characters), but converts the Unicode on the fly to ANSI before passing it to 
the DLL function as a null-terminated string. 

Things get interesting when strings are passed by reference. VB3 passes a handle 
to a string (HLSTR) in that case, and your DLL function has to use the CDK API func¬ 
tions if it wants to properly manipulate that string (access the contents, change the 
size, etc.). Suppose that you are writing a DLL function called IntToStrParm( ) that 
converts an integer into a string and is called from VB like this: 

Declare Sub IntToStrParm... 

(ByVal N As Integer, S As String) 

Dim NInt As Integer 
Dim NStr As String 
NInt = 12345 
IntToStrParm NInt, NStr 


Howard Kapustein is a senior programmer for Shared Medical Systems in Pennsylvania. 
He designs and develops software for Win 32, Windows, and OS/2 using C++ and Visual 
Basic. He can be reached at hskO@voicenet.com. 
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Figure la shows how you might implement the VB3 (CDK- 
based) version of the DLL function. VB3 passes a handle to an 
HLSTR, and the code uses CDK functions to manipulate it. 

On the other hand, the VB4 documentation is confusing on 
the subject of passing strings by reference, stating that VB4 
passes strings as "pointers to OLE strings" (BSTR*) which are 
"converted from Unicode to ANSI strings (and back on 
return)". Actually, both statements are true, though the 
description of the actual process is poorly worded at best. The 
rules change slightly with the 32-bit version of VB4. Here's 
what effectively happens: 

• VB4 copies the string (NStr) to a temporary buffer, null-ter- 
minates it, and converts the 16-bit Unicode characters to 8- 
bit ANSI characters. 

• VB4 calls the DLL function with a pointer to the first charac¬ 
ter in the temporary ANSI string. (This is not the same as the 
beginning of the string, since OLE strings are actually struc¬ 
tures consisting of a size field followed by string content). 

• When the function returns, VB4 converts the string contents 
from ANSI to Unicode and copies the Unicode back to the 
Visual Basic string variable (NStr). 

Now compare the 16-bit VB4 version of this DLL function 
in Figure lb with the CDK-based version for VB3 in Figure la. 
You'll notice a few changes. First, the 16-bit VB4 version uses 
the WI NAP I calling convention instead of VBAPI. The VBAPI sym¬ 
bol was defined by the CDK; WINAPI expands to PASCAL for 
Winl6 (or_ stdcal 1 for Win32). (Tip: if you have a lot of exist¬ 

ing code, you can easily #defire VBAPI as WINAPI in a common 
header file for your project.) Second, in Figure lb the string 
parameter is CHAR** instead of HLSTR — more on this later. 
Finally, the code uses SysReAl 1 ocString( ) instead of 


Figure 1 a IntToStrParm for VB3 (CDK API) 


VOID VBAPI IntToStrParm!const SHORT N, HLSTR S) 

{ 

// Convert an Integer to a String 

CHAR NStr[ 1+5+1 ]; // sign + 5-digits + null 

sprlntf(NStr. "Ihd”, N); 

// Convert C String to VB String 
if (S - 0) 

( 

// Create the VB String 
S - VBCreateHlstrINStr, strlen(NStr)): 

} 

else 

t 

// Update the VB String 

VBSetHlstr(&S, NStr, strlen(NStr)); 

} 

} 


Figure 1 b IntToStrParm for 16-bit VB4 (16- 
bit OLE API) 


VOID WINAPI IntToStrParmCconst SHORT N, CHAR * * S) 
( 

// Convert an Integer to a String 

CHAR NStr[ 1+5+1 ]; // sign + 5-digits + null 

spri ntf (NStr, "Xhd", N); 

// Convert C String to OLE String 
SysReAl1ocString(S, NStr); 

} 


VBCreateHl str () or VBSetHl str (). Using the OLE API has actu¬ 
ally simplified the code (SysReAl 1 ocStri ng( ) can either create 
a new string or update an existing one). 

The code in Figure lb works for Winl6 but won't compile 
for Win32, failing on the SysReAl 1 ocString( ) statement. The 
secret is in the definition of a BSTR. The BSTR data type is 
defined in the OLE headers as OLECHAR*, but OLECHAR is defined 
as CHAR for Winl6 versus wchar_t for Win32. Visual Basic 
always passes OLE strings containing ANSI characters 
(CHAR*), but the 32-bit OLE API expects Unicode characters 
(wcha r_t*). The solution is very simple: lie to the OLE API (just 
a little white lie). Cast the string parameter to BSTR* like so 

SysReAl1ocString( (BSTR*) S, NAsCString ); 

and it fixes everything. This is redundant for Winl6, where 
BSTR* and CHAR** are synonyms. 

I don't know why the Win32 OLE string APIs accept ANSI 
characters equally as well as Unicode, but they do (probably 
by design, for this very purpose). The fact that the string obeys 
OLE's layout probably has something to do with it; just any 
old ANSI string will probably be rejected (or cause unexpect¬ 
ed side effects, protection violations, etc.). I haven't investigat¬ 
ed OLE non-string APIs for this feature, but those operate on 
the string (not merely converting it), so I doubt they accept 
ANSI characters. 

Why not just declare the C/C++ parameter as BSTR*? Either 
way works for Winl6 and this solves the Win32 OLE string 
API problem, but since the contents really are ANSI, any 
manipulations you perform would need a CHAR** cast. I found 
we use the OLE APIs far less often than the string's contents, 
so I prefer casting at the call to the OLE function. 

String return values are much simpler than string parame¬ 
ters. Suppose a different version of the DLL function, one that 
returns the string it constructs and is called from VB like this: 

Declare Function IntToStrRet... 

(ByVal N As Integer) As String 


Figure 2a IntToStrRet for VB3 (CDK API) 


HLSTR VBAPI IntToStrReUconst SHORT N) 

{ 

// Convert an Integer to a String 

CHAR NStr[ 1+5+1 ]; II sign + 5-digits + null 

sprintf(NStr. "Xhd", N); 

// Convert C String to VB String 

return! VBCreateTempHlstrlNStr, strlen(NStr)) ); 

} 


Figure 2b IntToStrRet for 16-bit VB4 (16-bit 
OLE API) 


BSTR WINAPI IntToStrReUconst SHORT N) 

( 

// Convert an Integer to a String 

CHAR N$tr[ 1+5+1 ]; // sign + 5-digits + null 

sprintf(NStr, "Xhd", N); 

// Convert C String to OLE String 
return! SysAl1ocString( NStr ) ); 

1 
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Dim NInt As Integer 
Dim NStr As String 
NInt - 12345 

NStr = IntToStrRet(NInt) 

Figure 2a shows the VB3 (CDK-based) implementation and 
Figure 2b shows a 16-bit VB4 implementation for 
IntToStrRetf ). The key difference is the string allocation call. 
Adding Win32 support to the mix adds a few twists, and 
Figure 3 shows how to create a single source module that can 
be compiled to support either 16- or 32-bit VB4. The primary 
difference is the ANSI/Unicode conversion of the string con¬ 
tents. The code is "passing ownership" of the return value (VB 
will handle deallocating it as necessary), but it must be a valid 
OLE string (this includes Unicode format for Win32). 

The sample in Figure 3 allocates an 
empty OLE string and then performs 
the ANSI-to-Unicode conversion direct¬ 
ly to the OLE buffer. This was optimal 
for our applications since the string 
lengths are rarely known in advance. 

Alternatively, you could perform the 
conversion to a local variable (on the 
stack) and then create the OLE string 
(viaSysAllocStringO). 

Variant Handling 

Developers manipulating variants 
will notice significant changes in the 
APIs, usage, and functionality, mostly 
for the better. Under VB3, the CDK 
defined the VARIANT data type as a struc¬ 
ture containing a single field of 16 
bytes. All variant handling required the 
use of CDK API functions. 

VB4 now uses the standard OLE 
VARIANT definition — a true structure 
containing a type field (vt) and a union 
of the various types of data elements 
(iVal, bstrVal, etc.) — which greatly 
simplifies variant manipulations. OLE 
variants also support the concept of by¬ 
reference (VT_BYREF), so a variant can 
contain the actual value (like VB3) or 
point to the value located somewhere 
else (if the VT_BYREF bit in the vt field is 
set). Some of the CDK API functions are 
now obsolete (you just directly access 
the fields in the structure) and others 
have direct OLE replacements. The 
Microsoft documentation covers this 
reasonably well. 

One thing to be aware of: when it 
comes to strings in variants, forget 
everything I've told you about strings. 

A parameter explicitly declared as a 
By Ref string will be converted to ANSI 
on the fly (and converted back on 
return), but a string field of a VARIANT 
parameter will not. Variants always 


contain true OLE strings, including Unicode characters in 
Win32 environments. VB4 only plays games with strings that 
are explicitly passed as parameters of Dec! a re'd functions. 

This is much easier shown than told, so here's a function 
that takes a variant containing some numeric value, con¬ 
verts it to a string, and returns the string length. Given the 
code: 

Declare Function NToStrLen... 

(N As Variant) As Integer 

the VB3 (CDK-based) implementation is shown in Figure 4 
and a VB416-bit implementation in Figure 5. You'll notice that 
accessing the type and value is much easier with the OLE vari¬ 
ant. The string handling in particular is much simpler, since 





for C/C++ 
-Unt Version 7.0 (New) 

presents Bug # 668 


1 

#include <stdio.h> 

2 

3 

int process( char ‘filename ) 

4 

< 

5 

FILE *f; 

6 

int count = 0; 

7 

8 

if( filename ) 

9 

< 

10 

if( f = fopen(filename, "r") ) 

11 

t 

12 

while( fgetc( f ) != EOF ) 

13 

count++; 

14 

> 

15 

fclose( f ); 

16 

> 

17 

return count; 

18 

> 


A potential disaster awaits the author/user of this innocent looking function. 
What is it? Call if you need a hint. Refer to Bug #668. 


PC-lint for C/C++ will catch this and many 
other bugs. It will analyze a mixed suite of C 
and C++ modules to uncover bugs, glitches, 
quirks and inconsistencies. 

Version 7 of PC-lint breaks new ground with 
inter-statement value tracking for both 
automatic variables and class data members. 
Taking clues from assignment statements, 
initializers and conditional expressions it can 
detect out-of-bound subscripts and potential 
null pointer uses. As an enabling technology, 
almost 100 standard functions are rigorously 
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repeated arguments having side-effects. 
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16-bit OLE strings can be read like any other null-terminated 
string. 

Now suppose you add 32-bit VB4 to the mix, enhancing 
the 16-bit VB4 code in Figure 5 to be compilable for either plat¬ 
form. Only the VT_BSTR case needs to modified, as shown in 
Figure 6. As you can see, the only difference is the 
Unicode/ANSI conversion for Win32. 

Modifying a VARIANT is just as easy, and is well document¬ 
ed. Just keep in mind that, if your function receives a variant 
from VB4 and you update its contents, you need to deallocate 
any existing contents before setting the structure elements. For 
example: 

VOID MakeltString( VARIANT * pV, 
const CHAR * pStr ) 

1 

if ( pV — 0 ) 
return; 

if ( pV->vt != VTJSTR ) 

{ 

if(GetScode(VariantClear(pV))!=S_OK) 

return; 

pV->vt = VTJSTR; 

pV->bstrVal = SysAl1ocString( pStr ); 

1 


Figure 3 IntToStrRet for VB4 (multiplatform 
OLE API) 


BSTR WINAPI IntToStrRettconst SHORT N) 

{ 

// Convert an Integer to a String 

CHAR NStrf 1+5+1 ]; // sign + 5-digits + null 

sprintflNStr, "3!hd", N); 

// Convert C String to OLE String 
BSTR BStr; 

#if defined(_WIN32) 

// ANSI strings need to be converted to Unicode 

// Determine the final length of the UNICODE string 
int Length - MultiByteToWideCharE CP_ACP, 0, NStr, 

-1, NULL, 0 ); 

if ( !Length ) 

{ 

// Error! 
return! 0 ); 

) 

// Allocate an uninitialized OLE string 
BStr - SysAl1ocStringLenC NULL. Length ); 
if ( BStr — 0 ) 

( 

// Error! 
return! 0 ); 

) 

// Convert C/ANSI String to OLE/Unicode String 
Length - MultiByteToWideChar! CP_ACP, 0, NStr, 

-1, BStr, Length + 1 ); 

if ( !Length ) 

{ 

// Error! 

SysFreeString! BStr ); 
return! 0 ); 

) 

#el se //Winl6 

// Convert C String to OLE String 
BStr - SysAl1ocString( NStr ); 

#endif 

II Success 
return! BStr ): 

) 


else 

1 

#if defined(_WIN32) 

//...Convert pStr (ANSI) to 
// UNICODE (into variable S)... 

SysReAl1ocString( &pv->bstrVal, S ); 
#else //Winl6 

SysReAllocStringt &pv->bstrVal, pStr ); 
#endif 
1 

1 


Unlike the string handling previously described, the variant 
logic is identical whether it's called from Visual Basic or any 
other tool. This is one case where the VB team didn't change 
the rules. 

I should also mention a "feature" of the VARIANTARG data 
type. The OLE documentation briefly mentions the difference 
between a VARIANT and VARIANTARG, but it's very easy to miss. A 
VARIANTARG is supposed to be equivalent to a VARIANT, but it 
can also contain references to values (VT_BYREF is never set in a 
VARIANT by contrast). Unfortunately, this type is of minor 
value, as VARIANTARG is simply a typedef for VARIANT! The com¬ 
piler won't even warn you about code like this: 

VOID f(VARIANT * pV); 

VOID g(VOID) 


Figure 4 NToStrLen for VB3 (CDK API) 


extern "C" SHORT VBAPI NToStrLen!LPVAR pVariant) 

{ 

// Check the parameter 
if ( pVariant — 0 ) 
return! 0 ); 

// Determine the Variant's contents 
CHAR NAsStringt 16 ]; 

VALUE Value; 

switch ( VBGetVariantVaTue(pVariant, SValue) ) 

{ 

case VT_I2: 

1 

// 16-bit integer 

sprintf(NAsString, "Hhd”. Value.i2); 
break; 

) 

case VT_I4: 

{ 

// 32-bit integer 

sprintf(NAsString, "%ld”, Value.i4): 
break; 

) 

case VT.STRING; 

{ 

// String 
USHORT Len; 

LPSTR pStr - VBDerefHIstrLen(VaTue.histr. Len); 
if ( (pStr-0) || (Len—0) ) 

( 

// No string 
return! 0 ); 

) 

long LVal - strtoKpStr, 0. 0) 
sprintf!NAsString, "Hid", LVal); 
break; 

) 

default: 

( 

// Don’t support other types 
return! 0 ): 

) 

) 

// Return the length of the string 
return! strlen! NAsString ) ): 

) 
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double SomeValue = 1234.5678; 
VARIANTARG V; 

Variantlnit(&V); 

V.vt = VT_R8 | VTJYREF; 
V.pdblVal = &SomeValue; 
f(&V); // This is a no-no! 


VB4's new Optional keyword lets you achieve a similiar result; 

Function Add(0ptional ByVal a As Variant, 

Optional ByVal b As Variant) As Integer 
Add - IifdsMissing(a), 0, Clnt(a)) + _ 

IifdsMissing(b), 0, Clnt(b)) 

End Function 


Ideally, this will never happen; however. I've found it helpful 
to declare parameters as VARIANTARG where appropriate but 
always add checks for VT_BYREF when handling a VARIANT 
(return an error, throw an exception, use assertions, etc.). If it's 
not declared as VARIANTARG, it doesn't handle VT_BYREF. This 
makes the code more self-documenting and helps prevent 
unexpected side effects. 

Optional Parameters 

The VB4 development team enhanced the core language in 
several areas, one of the more useful additions being optional 
parameters. This differs somewhat from C++, which supports 
default parameters. C++ lets you write: 

int Add(const int a - 0, const int b=0); 

void foo(void) 

{ 

int n; 

n - Add(); // same as Add(0,0), n=0 
n = Add(7); // same as Add(7,0), n=7 
n = Add(7,2);// same as Add(7,2), n=9 
1 


Figure 5 NToStrLen for 16-bit VB4 (16-bit 
OLE API) 


extern "C" SHORT WINAPI NToStrLen!VARIANT * pVariant) 

{ 

// Check the parameter 
if ( pVariant — 0 ) 
return! 0 ); 

// Determine the Variant's contents 
CHAR NAsStringt 16 ]; 
switch ( pVariant->vt ) 

( 

case VT_I2: 

( 

II 16-bit integer 

sprintf(NAsString, "IM", pVariant->iVal); 
break; 

} 

case VT_I4: 

( 

// 32-bit integer 

sprintfdiAsString, pVariant->lVal); 

break; 

) 

case VT.BSTR; 

{ 

// String 

if ( pVariant->bstrVal — 0 ) 
return! 0 ); 

long LVal - strtol(pVariant->bstrVaI. 0, 0) 

sprintf(NAsString. "l\i", LVal); 

break; 

1 

default: 

( 

// Don't support other types 
return! 0 ); 

) 


// Return the length of the string 
return! strlen! NAsString ) ); 


Dim n As Integer 
n = Add!); // legal, n=0 

n = Add(7); // legal, n=7 

n = Add(7,2); // legal, n=9 

C++ requires a value for all parameters; defaults are allowed, 

but eventually the compiler must be able to pass a value for all 
parameters. By comparison. Visual Basic allows the function 
to be called with missing parameters. The secret is OLE's vari¬ 
ant data type. In fact, VB4 requires optional parameters to be 
passed as variants. The IsMi ssi ng() function in VB4 can iden¬ 
tify if a parameter isn't passed, allowing the function to act 
appropriately. In the example above, I considered a missing 
parameter equivalent to a value of zero, but I could easily 
have done entirely different processing if I chose. 

How does IsMissingO work its magic? This isn't explicitly 
documented, but, interestingly enough, OLE supports optional 
parameters. A little detective work quickly shows how 
IsMissingO works. Variants can contain a variety of data 
types (indicated in the vt field), including something called 
VT_ERR0R. The OLE documentation states: 
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Figure 6 string case of NToStrLen for VB4 (multiplatform OLE API) 

case VT BSTR: 

pVariant->bstrVa1, -1, 

{ 

pAnsiStr, Length+1, 

// String 

NULL, NULL ); 

if ( pVariant-XbstrVal — 0 ) 

if ( !Length ) 

return! 0 ): 

( 

long LVal; 

delete pAnsiStr; 


returnt 0 ); 

#if def1ned(_WIN32) 

) 

// 32-bit BSTR is a Unicode string. Convert it to ANSI 

// Now finally what we came for... 


LVal * strtol(pAnsiStr, 0, 0) 

// Determine the length of the ANSI string 


int Length = WideCharToMultiByte( CP ACP, 0, 

// Delete the buffer 

pVariant->bstrVal. -1, 

delete pAnsiStr; 

NULL, 0, NULL, NULL ); 


if ( ! Length ) 

//else // Win 16 

return! 0 ); 



// 16-bit BSTR is a CHAR * w/ANSI characters 

// Allocate a buffer 

LVal - strtol ( pVariant->bstrVa1. 0, 0) 

CHAR * pAnsiStr - new CHARE Length + 1 ]: 


if ( pAnsiStr == 0 ) 

#endif 

return! 0 ); 



sprintf!NAsString, "%ld", LVal); 

// Convert it 

break; 

Length - WideCharToMultiByte! CP_ACP, 0, 

i 


An SCODE was specified. The type of the error is specified in 
scode. Generally, operations on error values should raise an 
exception or propagate the error to the return value, as appro¬ 
priate. 

Perhaps it's not so magical after all. VB4's IsMissingO func¬ 
tion is a simple test for VT_ERR0R, equivalent to: 


Function IsMissing(ByVal V As Variant) As Boolean 
IsMissing = Iif(VarType(V)=VT_ERROR, True, False) 
End Function 


This is very handy 
C/C++ version can 
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Custom Porting Services Also Available 


for DLLs which manipulate variants. A 
be implemented as: 

BOOL IsMissing(VARIANT * pV) 

1 

if (pV = 0) 
return(TRUE); 

return! (pV->vt == VT_ERR0R) ? 

TRUE : FALSE ); 

1 

Functions with optional parameters 
always get a parameter, even if you 
don't specify one: VB4 makes a tempo¬ 
rary variant containing type VT_ERR0R, 
passes it to the function, and on return 
destroys the temporary variant. You can 
think of it much like the way C++ can 
create temporary objects when calling 
functions. 

Conclusion 

Visual Basic 4.0 is more powerful 
than its predecessor, but Microsoft 
missed a few details in the documenta¬ 
tion, which translates into more work 
for you and me. I've found Visual 
Basic to be a powerful tool for the 
things it does well, and the ability to 
augment it with tools such as C/C++ 
has been critical to making successful 
products. And after all, isn't that what 
it's all about? □ 
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WinHEC 96 Conference Report 

Paula Tomlinson 


WinHEC has always been one of my favorite conferences. 
At WinHEC, we trade discussions of Win32 APIs and C++ 
classes for hardware protocols and demonstations of hard¬ 
ware that the average user might not see for a year or two yet 
(or never, if the hardware vendors guess wrong). WinHEC 
started out several years ago as a fairly obscure conference, 
pushed along mostly by the operating system heavyweight 
Microsoft and the microprocessor heavyweight Intel. I was 
surprised last year when the attendance doubled from the 
previous year. This year, once again, WinHEC 96 attendance 
roughly doubled — to more than 3,000. Like most technical 
conferences these days, WinHEC is really both a technical con¬ 
ference and a tradeshow. Technical sessions generally ran 
from about 8:00AM to 5:00PM, and the tradeshow floor (with 
a free buffet sponsored by various companies) was open on 
Monday and Tuesday from 5:00PM to 8:00PM. At the 
tradeshow, a few vendors were showing off development 
tools, but most of the vendors are at WinHEC to show off their 
latest hardware — such as dual-processor PowerPC systems 
and prototype USB joysticks. 

Bill Gates kicked off the conference again this year in a 
keynote address that featured the five buzz acronyms that 
were mentioned over and over during the three days of the 
conference (April 1 - April 3). The first of these was SIPC 
(Simply Interactive PC). A response to the Internet appliance 
crowd, the Simply Interactive PC is the latest big push at mak¬ 
ing PCs a true consumer electronic device. Don't confuse SIPC 
with PC97, though. PC97 (draft specs are available at 
http://www.microsoft.com/windows/thirdparty/hardware) 
describes the baseline Windows hardware platform for 1997, 
while SIPC describes the whole system framework (including 
the operating system, external devices, and applications). 
SIPC is the system-wide goal or target, while the remaining 
acronyms (USB, 1394, OnNow, and WDM) are some of the 
important pieces and strategies needed to get there. 

USB and 1394 

The Simply Interactive PC initiative rests partly on the 
premise that in order for PCs to become a truly accepted home 
consumer device, they must function more like other con¬ 
sumer devices. Consider VCRs, for example. No one has to 
open up the VCR to connect a video or audio component to it. 
The Simply Interactive PC will likely have a similar "sealed- 
box" packaging in order to succeed in the mass home con¬ 
sumer market. Since users will still want to connect these 
home PCs to devices like digital cameras, digital video disks, 
and joysticks, connectivity is as important as ever. In order to 
meet these goals, makers of external devices need to converge 


on just one or two standard interfaces that will exist as exter¬ 
nal plugs on the new SIPC systems. That's where USB 
(Universal Serial Bus) and 1394 come in. USB has very wide 
support among system vendors, and it seems likely that, 
before too long, most systems will ship with external USB con¬ 
nectors. Since USB is designed as a fairly inexpensive, low- 
throughput interface, some of the first USB devices that will 
appear will be simple input devices (keyboards, mice, and joy¬ 
sticks). The IEEE 1394 specification is a higher speed protocal 
(sometimes referred to as Serial SCSI) that probably won't be 
standard on lower-end systems for a while. Devices that trans¬ 
fer large amounts of data, such as digital cameras, will no 
doubt eventually be 1394 devices. 

OnNow 

Another important distinction between the way computers 
and other home electronic devices work has to do with how 
you turn them on and how they operate when not in use. Over 
the years, quite a bit of work has been done on managing 
power consumption on notebook computers, but desktop 
computers have always followed a model in which the com¬ 
puter is completely off or it's completely on. And it's a slow, 
tortuous process to go from completely off to completely on 
(booted). Devices like VCRs and microwaves aren't typically 
powered off completely when not in use; they tend to run con¬ 
tinuously, available for immediate use. These are the daunting 
issues that the OnNow initiative is trying to address. 
Supporting OnNow involves the PC, the operating system, 
devices/peripherals, and even applications. An OnNow-com- 
patible PC would have a "soft" OFF switch that leaves the sys¬ 
tem running at a low power state. The system still needs to be 
aware enough to perform certain scheduled tasks (such as 
downloading morning traffic information) and to wake up for 
certain events, such as an incoming fax. Not only does the sys¬ 
tem (including peripherals) need to operate at a low power 
state when sleeping, it also needs to do so quietly. That means 
the fans are off, which is just one of the technical issues ahead. 
I do look forward to the day when my system is available in a 
few seconds, as opposed to a few minutes. 

Win32 Driver Model 

Device-driver writers have been waiting a long time for 
news of a unified driver model between Windows 95 and 
Windows NT and it finally happened. Steve Madigan, of 
Microsoft's Desktop and Business Systems Division, 
announced that by, roughly, 1998, the Windows family would 
be operating under a common kernel — the NT kernel. So, it's 
not too surprising that the WDM driver model is based on the 


Paula Tomlinson has been developing DOS, Windows, and Windows-NT based applications and device drivers for eight years. The opin¬ 
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inserted. 
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existing Windows NT driver model, with extensions to 
include the important Windows 95 features of Plug and Play 
and Power Management. WDM drivers may be supported on 
Windows 95 and Windows NT as early as late 1996. Now that 
this common model is in view, a few developers were dis¬ 
gruntled by the thought of losing their investment in learning 
to write VxDs. Most were calmed by the promise of back¬ 
wards compatibility within each Windows platform (though 
not across platforms). In other words, VxDs will continue to 
be supported on Windows 9x for some time and kernel-mode 
drivers written for Windows NT 4.0 and earlier will continue 
to run on future versions of Windows NT for some time. What 
will not be supported, however, is VxDs running on Windows 
NT or drivers written for NT version 4.0 or earlier on 
Windows 9x. If you're writing device drivers, the clear mes¬ 
sage was to start looking at the current Windows NT driver 
model as a path towards the Win32 driver model. 

ActiveX and DirectX 

The ActiveX and DirectX technologies also received a fair 
amount of attention at the conference, acknowledging the 
need for high quality sound and graphics for the home con¬ 
sumer market. In fact, some of the more impressive demon¬ 
strations involved very large, high-resolution, "living room"- 
style displays. 

Conference Materials 

WinHEC 96 attendees took home a binder full of presenta¬ 
tion information, as well as the follow- 
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ing CD-ROMs: Windows NT 4.0 Beta 1, 
Win32 SDK, Windows NT DDK, a pre¬ 
release copy of the BackOffice 2.0 SDK, 
2 CD-ROMs contaning the conference 
preceedings, and a CD-ROM contain¬ 
ing the Hardware Compatibility Tests 
(HCTs). I also picked up a CD-ROM at 
the tradeshow that contains the USB 
specification. Finally, anyone who filled 
out the conference evaluation form 
received a copy of the Windows 96 
Game trial pack (trial versions of about 
20 Windows 95 games). 

Important Dates 

The following Windows platform 
dates were announced at the confer¬ 
ence, as well as in press releases that 
went out during the week of the confer¬ 
ence. 

• Mid 1996 — Windows NT 4.0 and 
Windows 95 OEM Service Release 2.0 

• Q3 1996 — Internet Add-on Pack 
("Nashville") 

• H2 1996 — Windows 95 OEM Service 
Release 3.0 

• CY1997 — "Memphis" and "Cairo" □ 
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Understanding NT 


Interactive Services 

Paula Tomlinson 


In reader comments on this column over the last few 
months, three subjects stand out: services, security, and device 
drivers. This no doubt reflects not only the level of interest in 
these topics, but also the lack of readily available information 
on them. In this month's column, I will focus on services. 

Calling MessageBoxO from a Service 

In an introductory article ("How to Write an NT Service") 
about Windows NT services in the February 1996 issue, I 
promised to follow up with more information about interac¬ 
tive services. This article prompted the following mail from 
Mark Bice: 


Your article was very timely for me as I am responsible for 
implementing a client/server product that will have an NT 
server side and probably need to run as a service. I was able to 
get the code samples from the article working, I even got 
WinDbg to capture the process output. I have one question 
though: Where does the output from the MessageBoxO call in 
the Servi ceHandl erf) function go to. I don't see the box, and 
the call from the service controller (which I'm using to send 
the PAUSE command) hangs since I can't clear the OK button. 


Thanks, 


Mark Bice 
Syntellect, Inc. 


I must apologize to everyone for that little snafu. I inadver¬ 
tently left a call to MessageBox( ) in the sample code I provided 
in the February column. I had originally intended to discuss 
how dangerous even the simple little MessageBoxO could be in 
a service. I decided to forgo that discussion until later but 
neglected to remove the MessageBox( ) call. If you run the sam¬ 
ple service as-is and attempt to pause the service, it will fail. 
The most common failure in this situation is that, the service 
controller will time out after about 30 seconds because it has 


not gotten any status back from the service. To enable the sam¬ 
ple service to operate correctly, simple remove the 
MessageBoxO call from the pause handling code in 
Servi ceHandl er( ). This problem, however, begs the question: 
When can you call MessageBox () from a service? For that mat¬ 
ter, when can you call Di al ogBox()? 

I will look at MessageBoxO first, since message boxes are a 
special case. A service does not have to be marked as interac¬ 
tive (I'll discuss this in more detail later) nor does it have to run 
in the LocalSystem account to call MessageBoxO. As the bug in 
my sample code showed, however, there are some restrictions 
and rules to calling MessageBoxO from a service. First, you 
need to specify the appropriate message box style flags, either 
MB_SERVICE_NOTIFICATION or MB_DEFAU LT_D ESKTOP_0NLY . If you 
need to display a message box whether or not a user has 
logged on yet and regardless of whether the application desk¬ 
top is active, then use MB_SERVICE_NOTI FICATION. If you want to 
display the message box only if a user has logged on and the 
application desktop is active, use MB_DEFAULT_DESKTOP_ONLY. 
Common examples of when the default desktop is not active 
include when the workstation is locked, when a screen saver 
is running, or when an alternate desktop is active. I'll dis¬ 
cuss desktops and window stations in more detail next 
month. 

The second reason my February sample code failed is that I 
attempted the call to MessageBoxt ) directly from time-critical 
code in the service: the service initialization code (in the 
ServiceMain( ) routine before the SERV I CE_RUNN I NG notification 
is sent) and the ServiceHandlerO routine. These routines are 
called directly by the service controller. If the service controller 
doesn't receive notification within a short period of time, it will 
decide the service has failed. Thus, if you need to display a 
message box during service initialization or in the 
ServiceHandlerO routine, it is crucial to make the call to 


Paula Tomlinson has been developing DOS, Windows and Windows-NT based applications and device drivers for eight years. The opin¬ 
ions expressed here are hers alone. She can be contacted via the internet at paulat@microsoft.com. 
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MessageBox() from a separate thread so that you can be guaran¬ 
teed to return back to the service controller in a timely fashion. 

In wdj S rv. C (Listing 1), I wrote a very small skeleton service 
that demonstrates calling MessageBoxO during service initial¬ 
ization. The complete source code for building the service is on 
the code disk (see Table of Contents for availability). If you real¬ 
ly need to wait for a response from the user before returning to 


Making Your Service Interactive 

❖ When calling MessageBox(), make sure you use either the 
MB_SERVICE_NOTIFICATION or the MB_DEFAULT_DESKTOP_ONLY 
flag. 

❖ Watch out — MB_S ERV I (^NOTIFICATION is #defined dif¬ 
ferently under different SDKs! 

❖ Avoid user interaction during the time-critical initializa¬ 
tion phase. 

❖ Make sure your service has the 
SERVICE_INTERACTIVEj.PROCESS flag. 

❖ Watch out — the user can prevent all service interaction 
by setting a flag in the registry. 
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the service controller, you can lengthen the amount of time the 
service controller waits by using a large value for the 
dwWaitHint field in the SERVICE_STATUS structure. Then send 
regular pending notifications (either SERVICE_START_PENDING, 
SERV I CE_ST0P_PENDING, SERVICE_CONTINUE_PENDING, or 
SERV I CE_PAUSE_PENDI NG), incrementing the dwCheckPoint field 
each time. This, of course, still requires using a separate thread 
to call MessageBoxO. This approach should really be avoided 
however, especially during service initialization (and especially 
for auto-start services). There is no way of knowing how much 
time might pass before the user dismisses the message box, and 
in the meantime, the service controller cannot start any remain¬ 
ing auto-start services. 

There's one other surprising complication associated with 
calling MessageBoxt ) from a service, one that has to do with the 
definition of MB_SERVICE_NOTIFICATION. Up through Windows 
NT version 3.51, MB_SERVICE_N0TIFICATION has been defined as 
0x00040000. When Windows 95 came along, a new message box 
style, MB_T0PM0ST, was defined with that same value. 
Apparently, in order to support the new MB_T0PM0ST style and at 
the same time avoid collisions with MB_SERVICE_NOTI FICATION, 
the value of MB_SERVICE_N0TIFICATION has been redefined as 
0x00200000. So, if you compile your service with newer 
include files (that is, those that use the new value of 
0x00200000 for MB_SERVICE_N0TIFICATION, as in from Visual 
C++ 4.0, the Windows 95 SDK, or the Windows NT 4.0 Beta 
SDK), the MessageBoxt ) call will fail under Windows NT ver¬ 
sion 3.51 with an error code of 1004 (ERR0R_INVALID_FLAGS). I 
did verify that the beta version of Windows NT 4.0 is capable 
of handling both the old (0x00040000) and the new 
(0x00200000) definitions of MB_SERVICE_N0TIFICATION. To be 
safe, you should double-check the definition of 
MB_S ERV I CE_N0TI FI CATION in the public include file that you are 
using to compile your service. If you want your MessageBoxt) 
call to work on both Windows NT 3.51 and Windows NT 4.0, 
you can either (1) ensure you are using the older definition of 
MB_SERV I CE_N0TI FICATION, (2) check the operating system ver¬ 
sion number before calling MessageBoxt ), or (3) add error-han¬ 
dling code around calls to MessageBoxt) to handle 
ERR0R_INVALID_FLAGS errors by using the older definition of 
MB_SERVICE_N0TIFICATION. 

In the Servi celni t () thread routine in wdjsrvc.c (Listing 
1), I demonstrate using the operating system version number 
to determine which definition of MB_SERV I CE_N0TI FI CATI ON to 
use. Since I compiled this service using Visual C++ 4.0, if the 
operating system is at least 4.0, then I use the current defini¬ 
tion of MB_SERVICE_N0TIFICATION (in winuser.h). Otherwise I 
hard-code the original definition of MB_SERVICE_N0TIFICATION. 

Interactive Services 

A truly interactive service requires a little more than the 
ability to call MessageBoxt ). To "interact" with a user, a service 
at least needs to be able to create a window or a dialog box. 
Before I discuss interactive services, I will first briefly review 
the LocalSystem account. 

Recall that services can run under either the LocalSystem 
account or an account that is specified during the call to 
CreateServiceO.Ifyou want to use a specific user account, then 
you have to specify the account name (typically a domain name 
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and a username) and the password (if any). Running under the 
LocalSystem account gives a service some of the same privi¬ 
leges that the operating system has. For example, only the 
LocalSystem account is allowed full access to certain registry 
keys (such as the Security key under HKEY_L0CAL_MACHINE). Since 
the LocalSystem account is not associated with any specific 
logged-on user, there are also some restrictions. For instance, a 
service running under the LocalSystem account cannot open 
the HKEY_CURRENTJJSER registry key. 

Under Windows NT 3.1, any services that ran in the 
LocalSystem account could access the desktop (display dialog 
boxes and windows). Consequently, any service running 
under LocalSystem could create a process that also ran under 
the LocalSystem account. This is very dangerous from a secu¬ 
rity perspective. Consider a service running in the 
LocalSystem account that decided to start up a command win¬ 
dow to run a batch file. A user could simply type Ctrl-C to 
stop the batch file and then have access to a command win¬ 
dow with LocalSystem permissions. 

To address these concerns, security was tightened up quite 
a bit on the LocalSystem account on Windows NT 3.5. Now, in 
order to interact with a logged-on user (i.e., be interactive), a 
service must have the SERVICE_INTERACTIVE_PR0CESS attribute. 
You specify this when the service is created or after the fact by 
calling ChangeServiceConfigt). A user can accomplish the 
same thing by using the Services applet to modify a service's 
Startup parameters. Only services that run under the 
LocalSystem account can have the 
SERVICE_INTERACTIVE_PROCESS attribute. Note that another 
effect of this tightened security is that the LocalSystem 
account has extremely limited access to network resources. 

Given that, there is no special code I need to add to my ser¬ 
vice to allow it create dialog boxes or windows. I just need to 
ensure that the service is created to run under the LocalSystem 
account and to have the SERV I CE_I NTERACTIV E_PR0CESS flag. In 
his book Win32 System Services (see References), Marshall 
Brain states that a service has to have aWinMainC) rather than a 
mainO in order for MessageBoxC), much less DialogBoxO, to 
work. I have never encountered such a restriction using the 
Microsoft SDK tools. Depending on your development envi¬ 
ronment, you may have to explicitly reference the libraries 
containing these functions. In wdjsrv.C (Listing 1) I demon¬ 
strate calling DialogBoxO from MainServiceThread(). Note 
that, just as with MessageBox(), you must avoid calling 
DialogBox() directly from time-critical service code. 

The S E RVIC E_I NTERACTIV E_P ROC ESS flag does not actual¬ 
ly guarantee that a service will be allowed to interact with 
the user. A user can override the 
S E RV IC E_I NTE RACTIV E_P ROC ESS flag on all services by set¬ 
ting the Nolnteracti veServi ces value under the 
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Windows 
key in the registry to 1. 

Interacting with the desktop implies more than just the 
ability to call DialogBox() and CreateWindow(). Access to the 
desktop (and the window station that owns the desktop) is 
required to call most USER32 and GDI32 functions. In addi¬ 
tion to the desktop itself, the window station is what owns 
the clipboard and the global atoms. By default, only interac¬ 
tive services can access these functions directly. However, 


Listing 1 wdjsrvc.c — A simple interactive 
service 


// wdjsrvc.c 

#include <windows.h> 

#include <stdio.h> 

^include "wdjsrvc.h" 

// private prototypes 

BOOL NotifySCMtDWORD, DWORD, DWORD); 

VOID ServiceMaintDWORD, LPTSTR *); 

VOID ServiceHandler(DWORD); 

DWORD ServicelnitILPDWORO); s 

LRESULT CALLBACK ServiceDlgProc(HWND, UINT, WPARAM, LPARAM); 

HANDLE hDoneEvent = NULL, hThread - NULL; 

DWORD dwCurrentState; 

SERVICE_STATU$_HANDLE hService; 

//. 

void main(void) 

{ 

SERVICE_TABLE_ENTRY ServiceTable[] - ( 

{GENSRV_ServiceName, (LPSERVICE_MAIN_FUNCTION)ServiceMain), 
(NULL. NULL) 

); 

// connect to the service control manager 
StartServiceCtrlDispatcher!ServiceTable); 

) 

//. 

VOID ServiceMaintDWORD dwArgc, LPTSTR *1 pszArgv) 

{ 

DWORD Threadld; 
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services that do not run under the LocalSystem account (and 
thus cannot be marked as SERVICE_INTERACTIVE_PR0CESS) can 
also interact with the desktop by impersonating the logged- 
on user and then opening the interactive window station and 
desktop directly. I'll discuss window stations and desktops 
in more detail in next month's column. 


References 

Knowledge Base Aritcles: Q115825, "Accessing the Application 
Desktop from a Service." Q132679, "Local System Account 
and Null Sessions in Windows NT." Q122702, "Using the 
System Account as a Service in Windows NT 3.5." 

Brain, Marshall. Win32 System Services. 2nd ed. Englewood 
Cliffs, NJ: Prentice Hall, 1996. □ 


Listing 1 continued 


if (UhService - Register$erviceCtrlHand1er( 

{ 

GENSRV ServiceName, 

SERVICE STATUS ServiceStatus; 

(LPHANDLER FUNCTION)ServiceHandler))) 


return: 

ServiceStatus.dwServiceType - SERVICE_WIN32_0WN_PR0CESS; 

ServiceStatus.dwCurrentState - dwCurrentState - dwState; 

NotifySCMtSERVICE_START_PENDING, 0, 1); 

ServiceStatus.dwControlsAccepted - SERVICE ACCEPT STOP | 

SERVICE ACCEPT PAUSE CONTINUE | SERVICE ACCEPT SHUTDOWN; 

CreateThread(0, 0, (LPTHREAD START ROUTINE)Servicelnit, 

ServiceStatus.dwWin32ExitCode - dwWin32ExitCode; 

NULL, 0, &ThreadId): 

ServiceStatus.dwServiceSpecificExitCode - 0; 

ServiceStatus.dwCheckPoint - dwProgress; 

NotifySCMtSERVICE_START_PENDING, 0, 2); 

ServiceStatus.dwWaitHint - 5000; 

if (KhDoneEvent - CreateEventtNULL, FALSE, FALSE, NULL))) 

return SetServiceStatusfhService, SServiceStatus); 

return; 

} 

NotifySCMiSERVICE_START_PENDING, 0, 3); 

//. 

DWORD ServicelnittLPDWORD ThreadParam) 

if (MhThread - CreateThreadt0, 0, 

{ 

(LPTHREAD START R0UTINE)MainServiceThread, 0, 0, 

0SVERSI0NINF0 OsVersionlnfo; 

SThreadld))) { 


CloseHandle(hDoneEvent); 

OsVersionlnfo.dwOSVersionInfoSize - sizeof(OSVERSIONINFO); 

return; 

1 

GetVersionExt&OsVersion Info); 

if (OsVersionlnfo.dwMajorVersion >- 4) { 

NotifySCM(SERVICE_RUNNING, 0, 0); 

TCHAR szMsg[MAX_PATH]; 

wsprintf(szMsg, TEXT("Using %08x"), 

WaitForSingleObjectChDoneEvent, INFINITE); 

MB_SERVICE_N0TIFICATI0N); 

CloseHandle(hThread); 

MessageBoxtNULL, szMsg, TEXTt"WDJSrvc"), 

CloseHandle(hDoneEvent); 

MB SERVICE NOTIFICATION | MB OK); 

return; 

) else { 

) 

//. 

VOID ServiceHandlertDWORD fdwControl) 

MessageBoxtNULL, TEXTt’UsIng 0x00040000"), 

TEXTt"WDJSrvc"), 0x00040000 | MB_0K); 


{ 

return TRUE; 

switch(fdwControl) { 

1 

case SERVICE CONTROL STOP; 


NotifySCMCSERVICE_ST0P_PENDING, 0, 1); 

//. 

SetEvent(hDoneEvent); 

DWORD MainServiceThreadtLPDWORD ThreadParam) 

NotifySCMtSERVICE STOPPED, 0, 0); 

{ 

break; 

DialogBoxtGetModuleHandle(NULL), 

MAKEINTRESOURCEtSERVICE_DIAL0G), NULL, ServiceDlgProc); 

case SERVICE CONTROL PAUSE: 


NotifySCM(SERVICE PAUSE PENDING, 0, 1); 

while (TRUE) { 

SuspendThreadthThread); 

Sleep(lOOOO); 

NotifySCMCSERVICE_PAUSED, 0, 0): 

MessageBeep(O); 

break; 

} 

return TRUE; 

case SERVICE CONTROL CONTINUE; 

} 

NotifySCMCSERVICE_C0NTINUE_PENDING, 0, 1); 


ResumeThread(hTh read); 

//.-. 

NotifySCMtSERVICE RUNNING, 0, 0); 

LRESULT CALLBACK ServiceDIgProc(HWND hDlg, UINT msg. 

break; 

WPARAM wParam, LPARAM IParam) 

case SERVICE CONTROL INTERROGATE; 

switch (msg) { 

NotifySCMtdwCurrentState. 0, 0); 

case WM_C0MMAND: 

break; 

switch(LOWORD(wParam)) { 
case ID0K; 

case SERVICE CONTROL SHUTDOWN: 

EndDialogthDlg, TRUE); 

break; 

return TRUE; 

J 

} 

break; 

//. 

return FALSE; 

BOOL NotifySCMt DWORD dwState, DWORD dwWin32ExitCode, 

) 

DWORD dwProgress) 

// End of File 
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Bug++ of the Month 

Mark Nelson 


If you discover a bug in the latest version of your favorite compiler, 
email it to us at wdletter@rdpub.com. Please specify which version 
of your compiler you are using and include a tiny program that 
demonstrates the problem, along with the exact command-line 
options needed to compile it. 

Borland hasn't had an easy time of it in the last few years. 
It's well known that butting up repeatedly against the 
Microsoft juggernaut can be hazardous to the health of a com¬ 
pany, and Borland's foray into desktop applications put it 
squarely in the path of the world's wealthiest programmer. 
Experience has shown that this isn't a good place to be. 

Borland's Rise and Fall 

Just a few years ago, Borland seemed to be on top of the 
world. Publicly proclaiming themselves to be "barbarians," 
Borland seemingly could do no wrong. Philippe Kahn proud¬ 
ly touted Borland's internal adoption of object-oriented tech¬ 
nology, and managed to convince Wall Street that he had cap¬ 
tured lightning in a bottle. 

But object-oriented development didn't pan out to be 
everything Philippe had hoped. The release date of dBase for 
Windows went through an agonizing slide, inadvertently 
handing the market to Access. At the same time, Microsoft 
slowly but surely cornered the suite market, which severely 
injured Borland's spreadsheet sales. 

Borland went through major restructuring, sold off large 
chunks of its line, and deep-sixed products that weren't pulling 
their weight. Philippe turned his attention to Starfish Software, 
and took SideKick along with him. In a very short period of 
time, Borland began looking like a very different company. 

One encouraging note for programmers was that Borland 
seemed committed to its line of development tools. Right 
through the turmoil, new releases of the Borland C++ compil¬ 


er and tools were issued, and we heard tantalizing talk about a 
revolutionary new product called Delphi. 

The New Borland 

In the last 18 months, Borland has given every appearance 
of being back on its feet. Delphi 1.0 has proven to be a success, 
and the release of 2.0 is garnering favorable reviews. Paradox 
7.0 likewise seems to be holding its own. 

Readers of this column should by now be aware of the 
release of Borland C++ 5.0. This new release of the flagship 
development product adds CodeGuard debugging, Java sup¬ 
port, MFC compatibility, and support for the ANSI Standard 
C++ library, including the STL. 

Borland also has adopted an interesting new stand on 
bugs, as evidenced by this quote from their Web page devoted 
to C++ 5.0 support: 

With the introduction of Borland C++ 5.0, Borland is taking an 
open approach to meeting developer needs after the launch of 
a major product. We are prototyping a program to publicly dis¬ 
close known bugs coupled with a strong effort to rapidly 
address problems identified by our customers. We are doing 
this in response to the requests we have heard from you and 
other developers. 

As patches are developed we will make them available online. 
With this release we will be providing more frequent patches 
much earlier in the lifecycle. 

I certainly like to hear this kind of talk! Now we'll see if 
Borland follows through on it. 

A Test 

WDJ reader Lior Golan sent in a report of an optimization 
bug in Borland C++ 4.5. It seems that the following code 


Mark Nelson is a programmer for Greenleaf Software in Dallas, Texas. Mark is the author of The C++ Programmer's Guide to the 
Standard Template Library, from IDG Books, as well as The Data Compression Book, from M&T Books. You can reach Mark on the 
Web at http://web2.airmail.net/markn. 
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doesn't work properly when compiled with the -Oc option, 
which enables local duplicate expression evaluation: 

irt buffer! 1 ] - { -1 }; 
unsigned char index = 0; 

int set_element( int flag ) 

{ 

int dummy = buffer! index ]; 
buffer! index ] = ( flag > 0 ); 
return dummy; 

1 

A quick look at the generated assemby code confirms the 
problem. 

; buffer! index ] - ( flag > 0 ); 

cmp word ptr [bp+4],0 
jle short @1@86 
mov ax,l 
jmp short @18114 
@ 1 @ 86 : 

xor ax,ax 
@18114: 

mov word ptr [bp-4],ax 


compiler. The program output looks like this: 
buffer! 0 ] = -1 

Note that the value should be either 0 or 1. 

Bug! 

Borland's Reply 

We found this bug also present in the beta version of 
Borland C++ 5.0, so we asked Borland if it would appear in 
the final release. Borland's response was: 

Yes, you're right, it's still a bug. We'll fix it in an upcoming 
patch, which should be ready before your June issue hits the 
stands. 

So it looks as if Borland is off to a good start with this new phi¬ 
losophy! We'll have to see how well it holds up over the life¬ 
time of the 5.0 release. 

Remember, if we use your bug in this column, you'll be 
rewarded with a handsome WDJ t-shirt. I'll look forward to 
hearing from you. □ 


Instead of storing the result in the static array, the generated 
code places the result of (fl ag > 0) into an automatic variable 
on the stack, where it is lost forever. 

The program shown in bug0696.cpp (Listing 1) demon¬ 
strates the problem with the 16-bit version of Borland's 
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Listing 1 bug0696.cpp 


tt 

// BUG0696.CPP 
// 

// The following bug illuminates a problem in the 
// Borland C++ 4.5 16 bit code generator. If you select 
// just the -Oc option, which performs local duplicate 
// expression optimization, the routine will fail 
// to correctly update buffer! index ]. Viewing the 
// generated assembly code shows that the value is 
// in fact not modified at all! 

II 

II Build with: bcc -Oc bug0696.cpp 
II 

#include <iostream.h> 

int buffer! 1 ] = { -1 1: 
unsigned char index = 0; 

int set_element( int flag ) 

1 

int dummy - buffer! index ]; 
buffer! index ] = ( flag > 0 ); 
return dummy; 


int mainO 
1 

set_element( 1 ); 

cout « "\nbuffer[ 0 ] - " 

« buffer! 0 ] 

« "\n"; 

cout « "\nNote that the value should be 
"either 0 or l!\n\n"; 
if ( buffer! 0 ] I- 1 ) 
cout « "Bug!\n"; 

else 

cout « "No bug I\n": 
return 1; 

1 

//End of file 
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Books in Brief 


First Impressions of Recent Titles 


Developing Custom Delphi Components 
Ray Konopka 
Coriolis Group Books, 1996 
585 pages 

$39.99, includes CD 
ISBN 1-883577-47-0 

[Editor's note: this review was provided by George Tylutki.] 
Delphi components have several advantages over other com¬ 
ponents. They are objects, so new components can be derived 
from (enhance) other components. They can be constructed 
from within the Delphi IDE using Object Pascal. They are 
linked into an application's executable file, which eliminates 
the version and namespace conflicts that distributing separate 
files entails. And converting 16-bit components to 32 bits is 
easy since the Visual Component Library was designed with 
the Win32 API in mind. However, building anything other 
than the simplest component is not a trivial task. If you intend 
to construct Delphi components, you should acquire Ray 
Konopka's Developing Custom Delphi Components. 

You don't have to be a Pascal expert to write Delphi com¬ 
ponents, but you should be familiar with object-oriented pro¬ 
gramming. In Chapter 2, Konopka explains Delphi's Object 
Model and points out how it differ from other models for 
Borland Pascal and C++ programmers. The chapter is not 
meant to serve as an introduction to object-oriented program¬ 
ming; its purpose is to familiarize experienced OOP program¬ 
mers with Delphi's object model. 

Konopka covers the spectrum of component creation, from 
enhancing existing components to building original non-win- 
dowed (graphical), windowed, nonvisual, and dialog compo- 


Ron Burk 

nents. His examples range from the simple (a 3-D label com¬ 
ponent) to the complex (an email component). Chapter 13 
focuses on data-aware components. In it Konopka provides a 
very good discussion of field objects and demonstrates how to 
build a non-visual component that encapsulates business 
rules. Chapter 14, "Property Editors and Component Editors," 
is a very thorough treatment of these subjects. Installing com¬ 
ponents and creating on-line help are the topics of Chapter 16. 

Chapter 15 contains an excellent discussion of using 
Delphi's debugger and Turbo Debugger for Windows to test 
and debug components at design time and runtime. However, 
not every reader has TDW and in any case the built-in debug¬ 
ger cannot always be used effectively. For example, a break¬ 
point in a Paint method will cause the Paint method to be 
called repeatedly in an infinite loop. So Konopka provides a 
small utility program to capture OutputDebugStri ng messages 
and a Text File Device Driver unit that converts Object Pascal 
writelr statements into OutputDebugStri ng calls. The mes¬ 
sages sent via wri tel n in your source code are displayed in the 
utility's window. The Text File Device Driver eliminates the 
need to manipulate null-terminated strings. Further, write 
and wri tel n are very flexible, allowing any number of para¬ 
meters of various kinds to be passed. Konopka's approach is, 
of course, a variation of the old method of including "print" 
statements in your code, but it is flexible and it does allow 
debugging at runtime and design time. 

Useful tables complement the text throughout the book, 
and there are several handy appendices. Appendix A describes 
the changes required to move your components from 16-bit 
Delphi 1.0 to 32-bit Delphi 2.0 and explains what Konopka had 
to do so that his components would work with both compilers. 
Appendix B is a complete list of the standard exception-class 
hierarchy —- which is helpful because the standard exceptions 



Got an opinion about these or other programming books? Send them to 70302.2566@compuserve.com. You can order any of the books 
that appear in Books in Brief from Miller Freeman, Inc. by calling (913) 841-1631, faxing (913) 841-2624, or sending email to 
rdorders@rdpub.com. If using fax or email, send the book title, author, and publisher along with your MasterCard or Visa number, expi¬ 
ration date, and phone number. 

To submit books for review, send them to: Ron Burk, 13846 NE 60th Way, #120, Redmond, WA 98052-4542. Please do not send press releases to 
this address. 
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are defined in various places in the VCL source files. 
Appendix C lists all of the types declared in the VCL and the 
units in which the declarations are made. Again very useful. 

There is no padding in the book, although a few screen 
shots and illustrations could have been omitted. The code list¬ 
ings contain a few errors, but the code I checked on the CD is 
correct. The chapter on exception handling is only fair: it 
begins with the same divide-by-zero error example that every¬ 
one uses and constitutes just a brief overview. You'll learn 
more about exception handling by studying the code than 
from this chapter. 

The index seems relatively complete, but I stopped check¬ 
ing when I discovered that it is not properly alphabetized. 
Here are six consecutive entries (without page numbers or 
subentries): 

common lib directory 
compiler error 
COMPLIB.DCL 
combo box 

Commands, debugging 
Compiler directive 

Further, there are duplicate out-of-place entries: "Destructor" 
appears after "Destroy destructor" and after "Design-time 
interface" (which comes after "Dithering"). Indexing is a diffi¬ 
cult job but alphabetizing the entries and eliminating dupli¬ 
cates should be a straightforward (even an automated) task. 
It's unfortunate that the index is substandard, since the book 
contains so much useful material. Assume that, to find a word 


starting with "c," for example, you will have to search all of 
the entries beginning with that letter. 

In addition to the book's source code, there are demos of 
five commercial products on the CD: Conversion Assistant, 
Component Toolbox, Eschalon Setup, Orpheus, and App 
Enhancement Components. There are also 163 .zip files that 
contain components, utility applications, utility routines, 
bitmaps, tips, and more. The components range from the 
mundane (calendars and About dialogs) to the complex (FTP 
and MIDI components). Some are quite sophisticated: a 
resource compiler; enhanced image components that support 
JPEG, PCX, and other graphic types; a TCP/IP sockets compo¬ 
nent. There are database components and applications for 
managing aliases; printing a table's structure; graphically dis¬ 
playing the connections among tables, data sources, and data 
sets; and for searching on any field inaTDataSource. Some of 
the .zips contain complete shareware packages with docu¬ 
mentation and help files, while others hold first-time projects 
by neophytes. You will probably find something on the CD 
worth the price of the book, but it will take a while; there is no 
index file and only 19 .zips are described in the book. 

The code is not copyrighted in the book or in the subdirec¬ 
tory on the CD containing chapter-by-chapter code files. 
However, in the CD subdirectory containing the entire suite of 
ready-to-install components' units, the source code is copy¬ 
righted. The only explicit statement regarding use of the code 
appears on the back cover: "A full suite of ready-to-use com¬ 
ponents with royalty-free source code." I assume that you can 


Windows _ 

□ DEVELOPER'S JOURNAL 

The Magazine for Windows Programmers 


Windows Developer’s Journal buys dozens of articles each year 
from readers like you. You don’t have to be a writer, but you do 
have to have a concrete topic of interest to other Windows pro¬ 
grammers. Most of the articles we use are built around short 
(100-300 lines), reusable code that solves specific problems of 
interest to Windows programmers. We are especially interest¬ 
ed in Visual Basic article proposals at this time. The easiest 
way to propose an article topic is to send email about your idea 


Call for Papers 

to the editor, Ron Burk, via CompuServe at 70302,2566 or 
Internet at 70302.2566@compuserve.com. Make sure you 
include an estimate of the number of lines of code involved. 

If you don't have access to email, you can fax your proposal to: 
Managing Editor, Windows Developer’s Journal, (913) 841-2624, or 
mail it to: Managing Editor, Windows Developer’s Journal, 1601 
West 23rd St., Suite 200, Lawrence, KS 66046-2700. 

(913) 841-1631; FAX (913) 841-2624. 


Visual Programming 

■ Proposals due 15 Apr 1996 
manuscripts due 15 May 1996 

Suggested topics: Enhancing the 
VB4 listview control. A reusable func¬ 
tion for adding your app to the system 
“tray.” A Delphi treeview control with 
automatic structured storage backup. 


Database Programming 

■ Proposals due 15 May 1996 
manuscripts due 14 June 1996 
Suggested topics: Five tips for 
faster ODBC queries. A C++ class 
that simplifies ODBC access. A top 
ten list of SQL tricks that save time. 


Graphics 

■ Proposals due 15 June 1996 
manuscripts due 14 July 1996 

Suggested topics: The world’s 
smallest icon editor. How to give 
window backgrounds a textured 
look. Tips for minimizing window 
repainting. A function to stretch 
bitmaps with anti-aliasing. 
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use and modify the components. Konopka's electronic 
addresses are listed, as is the address of the Coriolis Web site 
(where you can get new and updated controls). 

Developing Custom Delphi Components was obviously written 
by someone who has created many components and has learned 
from the process. It covers all aspects of component building 
clearly and in detail, and will save you time and money. 


The Power of Frameworks for Windows 
and OS/2 Developers 
Taligent, Inc. 

Addison-Wesley Developers Press, 1995 

336 pages 

$39.95 

ISBN 0-201-48348-3 


A faceless corporation (Taligent) is listed as the author of this 
work, which is unfortunate since the person who actually wrote 
it (Andrew Shebanow) has created a rare thing: a decent book 
for PC programmers. He selected a specific, limited topic, stuck 
to it, and avoided injecting his ego into the process. Sounds sim¬ 
ple, but I estimate that about 80 percent of the books I receive 
cannot even meet the first of these criteria. Instead, they try to 
cover huge, general topics (e.g., object-oriented programming, 
software engineering, C++, Windows programming) in the 
vain hope of capturing the ever-elusive mass market. 

The topic here is C++ frameworks. This is an important 
topic, but not one that has been the subject of frenzied hype, so 
I'll explain why it is important. Programmers often try to 
achieve reuse by using C++. Unfortunately, it turns out that 
concrete C++ classes are usually not a good way to achieve 
reusable code. C++ templates can help, as the Standard 
Template Library shows, but this is reusability on a somewhat 
microscopic level. Frameworks, on the other hand, are collec¬ 
tions of C++ classes that solve a common portion of a set of 
problems, leaving open mechanisms (such as class derivation 
and virtual functions) for gracefully solving the variable parts 
of the problem set. Frameworks are one of the best ways to 
achieve software reuse on a macro level. 

Frameworks do not have to be as huge and unwieldy as the 
Microsoft Foundation Classes or Borland's OWL (the two 
frameworks programmers hear the most about). Frameworks 
can be used to tackle much smaller and more specific problem 
domains, such as editing graphical shapes, or managing con¬ 
versions between numbers of different units. Unlike a con¬ 
crete C++ class, which solves a specific problem and may be 
reusable, a framework's primary rationale is reusability (and 
it may also solve one or more specific problems). 

As with object-oriented programming in general, frame¬ 
works require a bit of reading and doing before you fully 
grasp the concept and begin to understand how to apply them 
to your own work. This book can help. The author briefly dis¬ 
cusses frameworks and then embarks on a real-life example 
(providing a grid of editable numeric cells). He first poses the 
problem and solves it using C++. He then proposes additional 
requirements, but rather than just revise the code to handle 
them, he shows how to generalize the problem and create a 
framework that can handle the set of problems, rather than 



just a single instance. The same problem is presented separate¬ 
ly (not interleaved, thank goodness) for Windows and OS/2, 
so you can follow whichever you choose. The code disk con¬ 
tains the complete code, so that you can tinker with your own 
variations on the author's idea. 

This is not the only book on frameworks you would ever 
need. Its goals are modest, but worthwhile: if you work 
through the author's example, you will understand the point 
of frameworks and how they can lead to truly reusable code. If 
you design C++ classes and you are not familiar with the con¬ 
cept of frameworks, I highly recommend this book. The world 
needs more books with modest goals like this one. 


C++: The Core Language 
Gregory Satir and Doug Brown 
O'Reilly & Associates, Inc., 1995 
207 pages 
$19.95 

ISBN 1-56592-116-X 



Writing a programming tutorial is harder than writing a 
reference manual — you're constrained from telling the whole 
truth because it is too complex, but you must also not mislead 
readers by telling lies or half-truths. In this book, the authors 
attempt to apply the O'Reilly "nutshell" style to teaching C++ 
to C programmers: their tactic is to teach only a subset, specif¬ 
ically, the portions they consider the core features of the lan¬ 
guage. They want to help the reader learn the fundamentals 
without getting hung up on the complicated syntax and 
semantics of the language. 

Though the authors indicated that the real challenge was 
in deciding which features to cover and which to leave out, I 
didn't see those decisions as especially critical; the problem 
with this book is the explanations themselves. In the very first 
example, the authors jump from a C implementation of a 
stack (a structure, along with functions to manipulate the 
structure) to a C++ class with public and private members. A 
much better path is that taken by Stroustrup in The C++ 
Programming Language: start with the structure and functions, 
then show that the functions can be made members of the 
structure, then show that struct and class are essentially 
interchangeable. Readers of this book will be ill-prepared to 
make the leap from structure plus functions to the completely 
unfamiliar class plus public plus private. Further, they are 
likely to be left with lingering uncertainties about the rela¬ 
tionship between struct and class, especially since this 
example is preceded by a chapter that explains that struct 
tags are type names, but is vague about the fact that this is not 
the equivalent of a typedef. 

I was also not enthusiastic about the authors' invention of 
terminology. For example, when a derived class calls a func¬ 
tion in its base class, the authors claim that this is called 
"chaining" — an especially unfortunate coinage, since some 
readers will infer that the compiler has actually compiled a 
chain of function pointers somewhere, or that this (nonexis¬ 
tent) chain can be tinkered with at runtime. 
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J SDK Annotation #117 

TYPE: Win32 
TOPIC: LB_DIR 
KEYWORD: LB_DIR 

If you pass a long filename to LB_DIR, it works 
under NT 3.51, but fails under Win95 because it 
relies on the 16-bit listbox which was not changed to 
handle long filenames. You can avoid the error by 
first translating the filename to a short filename by 
calling GetShortPathName().The LB_DIR will not 
fail, but it will still display only the short versions of 
any long filenames in the subdirectory. 

Reference: Microsoft Knowledge Base article Q131286 

Get the entire set of annotations from www. wdj. com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications” 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 



On the good side, the book was not rife with factual errors, 
which elevates it above the typical C++ tutorial book. The 
text does hit some of the common questions C programmers 
ask ("Is there no realloc operator to go with new and 
delete?"). On the whole, though, I don't recommend this 
tutorial for C programmers wanting to learn C++ — I think 
most programmers will go farther faster with Stroustrup's 
book, among others. 


PC Internal System Programming, 5th Ed. 

Michael Tischer 
Abacus, 1995 
739 pages 
$59.95 

ISBN 1-55755-282-7 

Here's a book in its fifth edition (that's saying something, 
as most PC books die after a fairly small first printing) that 
I've never laid eyes on before. That's unfortunate, because I 
could have used this book in the past. It's basically a miniature 
encyclopedia for DOS programmers, and it covers a high per¬ 
centage of the topics I've rarely been able to find in one place. 

Topics covered here include the PC hardware, video card 
programming, PIC programming, the DMA controller, the ser¬ 
ial port, the parallel port, the keyboard controller, joysticks, 
the mouse, expanded memory, extended memory, the floppy 
drive, hard disks, the realtime clock, BIOS configuration infor¬ 
mation, basics of DOS interrupt programming, DOS device 



drivers, the multiplex interrupt, detecting Windows, 
DoubleSpace, TSRs, extended DOS, DPMI, VCPI, CD-ROMs, 
Sound Blaster cards, and more. 

Rats! Where was this book when I really needed it? Well, it 
may have been in Germany, as this looks like another title 
translated from German. I'm finding that a high percentage of 
the migrated-from-Germany books landing in my lap are 
quite good; either they just write much better books over 
there, or else only the very best get translated and sent to com¬ 
pete in the American market. If you're looking for a nice all- 
around PC programming reference, check this one out. 


Readings on Microsoft Windows and WOSA 
Microsoft Press, 1995 
492 pages 
$39.95 

ISBN 1-55615-836-X 


The ultimate proof of Microsoft's marketing power is that 
they've been able to convince people that they know how to 
make good (as opposed to just very profitable) software. 
Highbrow professors (at least the kind who don't write very 
much code themselves) now make the pilgrimage to 
Redmond to learn about innovative new techniques such as 
assertions and source-code control. In the post-Cold War era, 
it is the Redmondites rather than the Russians who claim to 
have invented everything that is good and wholesome. 

This marketing of the image of quality takes concrete shape 
with the Microsoft Certified Solution Developer program. 
Microsoft, the company that trained an entire nation of end 
users never to buy software with a version of x.O, will charge 
you money to certify that you have passed a test of their devis¬ 
ing. And the fact is, that certificate will open some doors for 
you in some places. Well, if you gotta have it, you gotta have 
it, so you just have to grit your teeth and do it. 

This book claims to be preparation for Microsoft's 
Operating Systems and Services Architecture I and II exams. 
Unfortunately, it isn't really closely targeted at the questions 
on the exams; instead, it offers globs of excerpts from existing 
Microsoft sources, such as MSDN articles, MS Press books, 
and so on. 

Most developers specializing in Windows programming 
will already have the MSDN CD-ROM, which is pretty much 
an extensive superset of this book (and to which the book 
refers you for more complete information). You can almost 
certainly get information more critical to actually passing the 
tests from a third-party company that specializes in helping 
developers come up with a winning score (the answer 
Microsoft wants and the right answer will not always be the 
same). I can't see much reason to buy this book. You can pick 
it up in the bookstore and quickly copy down the topic areas 
(e.g., "Describe the role of the Windows Messaging System 
and each of its components"), then go home and use the 
MSDN CD-ROM to study. 



Microsoft Windows 
and WOSA 


ES8 
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Let's Talk Books 

From: ola.gunnars@sto.fdata.se 
Subject: Book reviews 

I need to say something about all letters regarding books 
and source code. A lot of people complain in "Books in Brief" 
about the source code and books larger than 500 pages. I like 
to read code to see how other people solve their problems, but 
I do not like to read code in a book that is on the MSDN or in 
some other SDK. That is what people should complain about. 

In the February, 1996 WDJ, T.V. Haridev invented a code- 
to-text ratio specification. Add code in SDK, code written by 
author, and text instead. 

Kindly, 

Ola Gunnars 

P.S. This column saves me a lot of money. 

That's a good point. I'm not sure a simple formida can work well 
for all or even most books, but it definitely would be useful to identi¬ 
fy code that’s easily available elsewhere (such as online) in the SDK, 
or automatically generated by compiler wizards. Saving readers 
money is the highest compliment I get. Thanks! —rib 

From: Floward Chalkley <HOWARD@gst-soft.demon.co.uk> 
To: haridev@pspl.ernet.in 
Subject: graphics books 
Dear Mr. Haridev, 

After reading your comments in the February, 1996 WDJ, I 
can strongly recommend the "Graphics Gems" series of books 
to anyone doing graphics programming. The classic Computer 
Graphics Principles and Practice by Foley and Van Dam is essen¬ 
tial as well. 

Howard Chalkley 

I agree with your selections, though neither is exclusively focused 
on 3D graphics. "Graphics Gems" is a great series of collected algo¬ 
rithms — long may it be published. Computer Graphics 
Principles and Practice by Foley and Van Dam is a general graph¬ 
ics classic that deserves a space on any graphics programmer’s shelf. 
3D Computer Graphics by Alan Watt is a more focused book and 
is recommended by my graphics guru friends. But we're really going 
well outside the Windows-specific book market to mention any titles 
of quality. I would be interested to hear if readers have found any 3D 
graphics programming books that are fundamentally Windows-spe¬ 
cific that they really like. —rib 

From: Charles Robertson <CROBERTS@novell.com> 

Subject: OLE books 
Ron, 

I am an experienced Windows programmer but new to 
OLE. I am looking for a book on OLE that will cover the basics 
as well as being a good reference on the subject. Since you 
write the "Books in Brief" column in Windows Developer's 
Journal, I hope you can recommend a good OLE book. I am a 
fairly new subscriber to WDJ, so I have missed previous issues 
where you may have reviewed OLE books. Please let me 
know of any OLE books you recommend. 

I look forward to your recommendation. 

Sincerely, 

Charles Robertson 


I am willing to recommend Kraig Brockshmidt's Inside OLE, 
2nd Ed., with the caveat that anything he says about C++ should be 
taken with a large grain of salt. Although I have a stack of OLE books 
on my shelf, I just haven't done enough OLE programming myself 
yet to pass judgement. I continue to learn more OLE in bits and 
pieces, though, so maybe in a few months I'll be able to do an OLE 
book roundup. —rib 

From: wongkw@pacific.net.sg (Wong Kok Wai) 

Subject: WDJ Feb 96 Book Review 

First, I would like to say that "Books in Brief" is always my 
favorite section of WDJ because of your honest reviews. Please 
continue your great work. 

Just some notes on your review on David Kipping's 
Migrating to Windows 95: .def files and an EXPORTS section are 
still needed if you want to target your DLLs for Visual Basic 
Version 4.0. If you don't include a .def file and the EXPORTS 
section when you compile your code, VB 4 complains with a 
"File not found" error, even if you declared the full path to the 
DLL. Details on writing DLLs for VB 4 can be found in an 
obscure file named vb4dll .txtin the VB 4 directory. 

I've seen some mention of this point online, but haven't looked 
into it. Thanks for the info. We also have an upcoming article with 
more useful tips for writing DLLs that work with VB4. —rib □ 


Jj SDK Annotation #118 

TYPE: Win32 
TOPIC: ReadFile 
KEYWORD: ReadFile 

The documentation correctly points out that Win95 
does not support OVERLAPPED I/O. Flowever, it 
incorrectly states that you must pass a pointer to a 
structure of type OVERLAPPED if the file was 
created (or opened) with the flag 
FILE_FLAG_OVERLAPPED. In fact, if you pass a 
pointer (rather than NULL) under Windows 95, 
ReadFile() returns FALSE, and GetLastError() 
returns ERROR_INVALID_PARAMETER, whether or 
not the file was created/opened with the 
FILE_FLAG_OVERLAPPED flag. That means that if 
you want to code a call to ReadFile() that works 
correctly for both synchronous and asynchronous 
I/O, you must detect at runtime that you’re running 
under Win95 and treat that case differently. 

Get the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications" 
of forum SDFOBUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 
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New Products 

Industry-Related News and Announcements 


Send your press release 
to Miller Freeman, Inc. 
1601 W. 23rd St. 
Suite 200 
Lawrence, KS 66046 


Ztech Ships VB Interface to NetWare 

Ztech has released a new version of their NetWare 
Interface for Visual Basic SDK. The kit contains all the 
DLLs needed to provide access to every function in the 
newest NetWare Client SDK. Visual Basic programmers 
can use the kit to attach file servers, obtain a list of current¬ 
ly logged-in users, verify passwords, list available print 
queues, identify workstation LAN card addresses, deter¬ 
mine which workstation is accessing specific files, maintain 


drive mappings, and more. The new version includes 
enhanced sample code, revised documentation, and easier 
installation. 

The NetWare Interface for Visual Basic SDK costs $195. 
For more information, contact Ztech Softivare, 1800 Lavaca, 
#109E, P.O. Box 981, Austin, Tx 78767, (512) 495-9101; fax 
(512) 495-1803; 74431.2047@contpuserve.com. 


fax 913-841-2624 
wdletter@rdpub. com 


Updated VCL Generator Imports Forms 

Component Create v2.1 is a tool for producing Delphi 
VCL components. It can help beginners create their first 
components or help experts handle the more tedious 
aspects of component creation. The new version features 
include: the ability to import container components from 
form files; the ability to make component properties invisi¬ 
ble in the Object Inspector; support for custom property 
editors; generation of tool palette bitmaps for your compo¬ 


nent; viewing of . dfm files; and an improved code editor 
that offers undo and smart tabbing. Component Create 
includes versions for both Windows 3.1 and Windows 
95/NT versions in the same box. 

Component Create v2.1 costs $179. For more information, 
contact Potomac Document Softivare, Inc., P.O. Box 33146, 
Washington, D.C. 20033, (800) 628-5524; (202) 244-9065; 

71726.651 @compuserve.com. 


Vision Software Updates Vision StoryBoard 


Vision StoryBoard is a Visual Basic tool that captures 
application specifications and requirements during the 
development process and generates current project docu¬ 
mentation and training materials. The new version targets 
the VB4 32-bit architecture, using its add-in feature to 
extend VB via OLE. While running with VB, Vision 
StoryBoard stores the specifications it captures as part of 

LPA Ships Fuzzy Logic Tools 

Logic Programming Associates has released FLINT, a 
Fuzzy Logic INferencing Toolkit that incorporates fuzzy 
logic techniques. Fuzzy logic lets you use imprecise infor¬ 
mation in a mathematically exact manner to add qualita¬ 
tive reasoning to traditional rule-base or expert systems. 
The kit supports standard and user-defined membership 
functions, linear and curved membership lines, automatic 
propagation of fuzzy values, a range of and/or/not combi- 


the VB project environment, providing immediate access to 
both the form and the project documentation. 

Vision StoryBoard v4.0 costs $249. For more informa¬ 
tion, contact Vision Softivare, 505 Fourteenth St., Suite 940, 
Oakland, CA 94612, (510) 238-4100; fax (510) 238-4101; 
ivww.vision-soft.com. 


nators, configurable linguistic hedges, and standard and 
user-defined defuzzification algorithms. 

FLINT costs $995 and includes the LPA Prolog compil¬ 
er and programming development environment. For 
more information, contact Logic Programming Associates 
Ltd., Studio 4, Royal Victoria Patriotic Building, Trinity 
Road, London SW18 3SX, England, 44 0181 871 2016; fax 
44 0181 874 0449; lpa@cix.compulink.co.uk; www.lpa.co.uk. 
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Crescent Ships VB Tools 

Class Action is a set of Visual Basic objects that pro¬ 
vides more convenient access to the Windows API. VB pro¬ 
grammers can use a familiar property/event/method 
approach to Windows API programming rather than 
declaring and calling straight C functions. The product also 
provides a library of error codes and conditions, raising 
errors at runtime when appropriate. 

RADBench is a new tool that snaps into the VB IDE and 
provides a range of enhancements including: bookmarks in 
form or code windows; a code manager for API definitions 
and user-defined subroutines; message box and common 
dialog designers; one-button commenting of code blocks; 
quick insertion of predefined subroutine headers and revi¬ 
sion marks; timed auto-saving; an assortment of control 
alignment tools; picture capture from screen to a control. 


StratosWare has updated MemCheck for DOS, their 
automatic error detection tool for C/C++ programmers. 
Requiring no source code changes, MemCheck detects 
memory overwrites, memory leaks, heap corruption, stack 
overwrites, stack overflow, out-of-memory conditions, 
invalid or unclosed file handles, and other errors. New fea¬ 
tures include the ability to detect copying data outside of 
the program space, to freed memory spaces, and to the 
code segment. This version also provides stack profiling 
and can detect invalid operations on file handles and fail- 


the clipboard, or a file; point-and-click setting of tab order 
(or automatically by position); a class wizard; and more. 

Crescent has split their PowerPak collection of VB tools 
into two products: a professional edition and an enterprise 
edition. The former consists of QuickPak Professional, True 
DBGrid, RADBench, VS-OCX, VsView/OCX, and XRef. 
The latter also includes ClassAction, SpyWorks-VB, Atilla- 
VB Pro Edition, VersionStamper, and VBCompress Pro. 

ClassAction costs $139. RADBench costs $119. PowerPak 
v2.0 costs $699 for the professional edition (upgrades are 
$349), or $1399 for the enterprise edition (upgrades are 
$699). For more information, contact Crescent, a division of 
Progress Software Corporation, 14 Oak Park, Bedford, MA 
01730, (617) 280-3000; fax (617) 280-4025; 
crescent@progress.com; www.progress.com!crescent. 


Traceback 

ure to close files. MemCheck for Extended DOS offers the 
same features, but also works with protected-mode appli¬ 
cations and can now generate symbolic stack traces for 
GPFs and other processor exceptions. 

MemCheck v3.5 Professional for DOS or Extended DOS 
costs $139. For more information, contact StratosWare, 

1756 Plymouth Rd., Suite 1500, Ann Arbor, MI 48105-1890, 
(800) WE-DEBUG or (313) 996-2944; fax (313) 996-2955; 
BBS (313) 996-2993; info@stratosware.com; 
www.stratosivare.com/swc. 


MemCheck for DOS: Faster, Offers Stack 


MicroHelp Ships Encryption/Password Library 


Encryption Plus is a new application and data security 
system that provides both encryption and password data¬ 
base management. The data encryption functions let you 
encrypt files, arrays, strings, and other blocks of memory. 
The application security functions facilitate creation and 
maintenance of a database of user IDs, passwords, and 
programmer-defined security flags. Encryption Plus also 


includes Data Encryption Standard (DES) (but not in the 
export version). The functions are accessible via a DLL, 
VBX, or OCX. 

Encryption Plus costs $249. For more information, con¬ 
tact MicroHelp, MicroHelp, Inc., 4211 J.V.L. Industrial Park 
Dr. NE, Marietta, GA 30066; www.microhelp.com; 
CompuServe: GO MICROHELP. 


Atria Updates Integrates SCM Tools with VB, VC++ 


ClearCase Attache v2.0 is the latest version of Atria's 
client software configuration management (SCM) tool for 
medium- to large-sized Windows development teams. The 
product uses a client/server architecture with clients run¬ 
ning on any Windows machine (3.x, 95, or NT) while the 
server runs on NT or UNIX. New features include 
Windows 95 support and access to SCM data from VB and 
Visual C++. This version also includes graphical browsers 


Code Checker Available for NT 

Pure Software has announced Purify for Windows NT, 
an NT version of their existing UNIX tool for detecting 
software errors and memory leaks. The program works by 
analyzing your compiled program and inserting checking 
instructions around every memory access in order to moni¬ 
tor runtime usage and report memory violations. The 
product can check all code involved, including third-party 


for viewing file and project information such as properties, 
history, and version trees. 

ClearCase Attache v2.0 costs $995 for the first user 
license. ClearCase 2.1 for Windows NT costs $4,000 for 
the first floating user license. For more information, con¬ 
tact Atria Software, 20 Maguire Road, Lexington, MA 
02173-3104, (617) 676-2400; fax (617) 676-2550; 
info@atria.com; wivw.atria.com. 


libraries and DLLs, not just code for which you have the 
source. 

Purify for Windows NT costs $1,298 per user, with an 
introductory price of $748 in the United States; the compa¬ 
ny expects to ship before July. For more information, con¬ 
tact Pure Software, Inc., 1309 S. Mary Ave., Sunnyvale, CA 
94087, (408) 720-1600;fax (408) 720-9200; info@pure.com. 
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Windows API Moving to OpenVMS? 

Mainsoft creates UNIX libraries that provide the 
Windows API for Windows programs being ported to 
UNIX. Now Mainsoft has announced an agreement with 
DEC to port the next version of their Main Win Studio to 
OpenVMS. This would make the Windows API (including 
MFC v4.0 and OLE 2.0), Microsoft Test, and Microsoft 
Visual SourceSafe available to developers writing for 


Softblox Updates Windows Integration 

SmartPad Pro is a tool that lets developers integrate, 
customize, and automate any combination of Windows 
applications. It can activate menu options in the current 
application, send keystrokes to an application, test for the 
existence of buttons and menu options in applications, cap¬ 
ture data from the screen, send and respond to OLE 
automation verbs, send DDE commands to any applica¬ 
tion, read/write databases via ODBC, and read/write stan¬ 
dard .ini files. The new version features Windows 95 sup- 


Three D Available for Win32 

Three D Graphics is now offering a 32-bit version of its 
Presentation Graphics SDK and editor for Windows 95 and 
Windows NT. The SDK lets developers add charts and 
graphics with a wide range of features. 3-D features 
include: the ability to rotate, scale, or distort a wire-frame 
outline of a 3-D chart; 16 preset 3-D viewing angles; and 
the ability to output 3-D charts as AutoCAD .dxf files. 
Special effects offered include: text and surface area drop 
shadows; color gradient fills for chart surface areas; the 
ability to scale or tile bitmaps onto chart surface areas; the 
ability to add pictures to risers or stack them one per grid 
to represent data quantity; and the ability to give most 2-D 
charts a 3-D effect by adding depth to the surface areas. 


Spinoza Cracks Quicken File Format 

VBXchange is a new Windows ODBC driver that gives 
Windows programmers access to Quicken 5.0 for Windows 
databases. As an ODBC driver, the software is accessible by 
most any Windows programming language, such as 
C/C++, Delphi, Visual Basic, etc. VBXchange represents 
Quicken data as relational database tables, allowing devel¬ 
opers to use SQL to query or update the users' data. The 
product also helps automatically ensure the data's integri¬ 
ty; for example, it can add the matching transaction for a 


Object Modeling Tool Supports VB 4 

Rational Software has announced Rational 
Rose/Visual Basic, an object modeling tool for Visual 
Basic 4.0 users. The product can automatically generate 
class modules and database schemas from business 
objects, and can generate remote automation objects from 
business rules. Rational Rose/Visual Basic supports the 
Booch '93 method, the Object Modeling Technique of 
analysis and design, and Jacobson's interaction diagrams 


Alpha and VAX systems running OpenVMS. 

Mainsoft expects to ship the OpenVMS version of 
MainWin Studio at mid-year for $5,000. For more informa¬ 
tion, contact MainSoft, 1270 Oakmead Parkway, Suite 310, 
Sunnyvale, CA 94086, (408) 774-3400; fax (408) 774-3404; 
info@mainsoft.com; wivw.mainsoft.com. 

Tool 

port, the ability to alter existing menu options or add 
entirely new menus, the ability to merge padsets in order 
leverage previous work, the ability to enable/disable but¬ 
tons via DDE commands, and a new icon editor (hundreds 
of predesigned icons are included). 

SmartPad Pro v3.5 costs $495. For more information, 
contact Softblox, Inc., 1201 West Peachtree St., Atlanta, 
GA 30309, (404) 892-0202; fax (404) 892-0981; 
softblox@delphi.com. 


Chart types include pie, bar, line, area, scatter, Gantt, 
log/linear, log/log, bubble, polar, radar, table, histograms, 
spectral maps, stock charts, and more. The Presentation 
Graphics Editor now offers OLE 2.x support and mimics 
the user interface in the Adobe Persuasion and Corel Draw 
charting modules (previously licensed to them by Three D 
Graphics). 

The Presentation Graphics SDK costs approximately 
$60,000 per year, depending on a variety of options. For 
more information, contact Three D Graphics, Inc., 1801 
Avenue of the Stars, Suite #600, Los Angeles, CA 90067-5908, 
(800) 913-0008; fax (310) 788-8975; info@threedgraphics.com; 
www.threedgraphics.com. 


transfer between accounts. VBXchange can read and write 
Quicken accounts, categories, classes, and bank, cash, cred¬ 
it card, asset and liability transactions. It supports level 1 
SQL API calls and the minimum SQL grammar with some 
core level functionality. 

VBXchange has an introductory price of $299. For more 
information, contact Spinoza Ltd., 11333 Iowa Ave., Los 
Angeles, CA 90025, (310) 231-9770; fax (310) 231-9773. 


for modeling business scenarios. 

Rational Rose/Visual Basic costs $2,400, which includes 
a year of support. For more information, contact Rational 
Software Corporation, 2800 San Tomas Expressway, Santa 
Clara, CA 95051-0951, (800) RAT-1212 or (408) 496-3600; fax 
(408) 496-3636; fax-on-demand (408) 496-3966; 
product_info@rational.com; www.rational.com. 
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Serial Data Acquisition Tool Comes to 

Win Wedge 32 is a new Win32 tool for making serial data 
from any device directly available to Windows applications. 
Besides the features in the company's existing Win Wedge 
Pro product. Win Wedge 32 offers: support for up to 99 serial 
ports; faster DDE transfers; the ability to receive data from 
multiple inputs simultaneously; baud rates up to 56K; and a 


SoftICE adds Pentium MMX Support 

NuMega has announced that SoftICE for Windows 95 
will gain support for the new Pentium MMX instructions. 
These are a set of primitive instructions that provide fast, 
low-level integer operations that can speed up common 
multi-media tasks such as manipulating large bitmaps in 
memory. As of this writing, Intel has not announced which 
chips the MMX instructions will appear on, but beta ver¬ 


WinHelp Office HTML Edition Available 

Windows help files are hypertext databases that share 
much in common with Web sites; they do not, unfortunate¬ 
ly, share a common file format. Now Blue Sky Software has 
enhanced their WinHelp Office 95 set of WinHelp tools to 
provide the ability to convert your Windows help file into 
HTML. It automatically transforms the WinHelp topics 
into Web pages and manages the conversion of WinHelp 
graphics formats into GIF files for the Web. You can use the 


Learning Tree Adds Eight Courses 

Learning Tree International has added eight new 
Windows-related training courses: TCP/IP 
Internetworking on Windows NT, NetWare to Windows 
NT Migration, Microsoft Systems Management Server, 
Microsoft SQL Server 6 — A Comprehensive Introduction, 
Microsoft SQL Server 6 System Administration, Advanced 
Windows Programming with Microsoft Foundation 
Classes, Windows Open Services Architecture, and Visual 


programmable hot key under Windows 95. 

Win Wedge 32 costs $495; upgrades from WinWedge 
Pro cost $129. For more information, contact TAL 
Technologies, Inc., 2027 Wallace St., Philadelphia, PA 
19130, (800) 722-6004 or (215) 763-7900; fax (215) 763-9711; 
tall@taltech.com; www.taltech.com. 


sions have appeared and the company has published the 
instruction set. 

SoftICE for Windows 95 costs $499. For more informa¬ 
tion, contact NuMega Technologies, Inc., 9 Townsend West, 
Nashua, NH 03063, (800) 468-6342 or (603) 889-2386; fax 
(603) 889-1135; info@numega.com; www.numega.com. 


tool to publish a single source of information in both 
WinHelp and HTML form. 

WinHelp Office 95 HTML Edition costs $897, with a 
promotional price of $699. For more information, contact 
Blue Sky Software Corporation, 7777 Fay Ave., Suite 201, 
La Jolla, CA 92037, (619) 459-6365; fax (619) 459-6366; 
sales@blue-sky.com; www.blue-sky.com. 


Basic 4 for Enterprise Applications. They also offer two 
new proprietary certification programs: Windows NT 
Systems and Networks, and Windows Application 
Development. 

For more information, contact Learning Tree 
International, 1805 Library St., Reston, VA 22090-9919, 
(703) 709-9119; fax (703) 709-6405; www.leamingtree.com. 
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Readers' Forum 


Send letters to wdletter@rdpub.com. 


Hi Ron, 

I was attempting to extend the tech¬ 
nique you described in the February 
1996 WDJ article "Bypassing Win95 
Printer Drivers" to NT 3.50. When I 
recompile the source code (with no 
modifications) provided using BC++ 
4.52, the application fails to load under 
NT 3.50 with a complaint about not 
being able to find winspool.dll. 
Everything works fine under Win95. 
The executable provided (from SDFO- 
RUM download) loads fine, but fails 
(as you indicated it would most likely 
do) when attempting to print. Any 
ideas or help would be greatly appreci¬ 
ated. Thanks in advance, 

A1 Yanchak 
AYC 

I'm not sure I know the answer, but I 
have an idea. After building the program 
with both Borland and Microsoft compil¬ 
ers and dumping the resulting .exe, I 
noticed that Borland was importing the 
spooler API functions from winspool .dll 
(there is no such file) while Microsoft was 
importing them from winspool .drv (that 
is where the spooler really does reside). My 
guess is that Borland made a mistake here, 
but that most of the time the spooler is 
already loaded, so any attempt to dynami¬ 
cally link to winspool.dll correctly 
locates the module named "winspool". If 
I'm right, then about the only way to work 
around this Borland bug is to dynamically 
load the spooler API functions yourself by 
explicitly loading winspool .drv and then 
calling GetProcAddress( ). My copy of the 
Borland C++ v5.0 beta also exhibits this 
behavior, so it may be around for a while, 
—rib 


From: Jim Weller 
<cimtech@hargray.com> 

Ron, 

I recently received my April issue of 
WDJ. In your "From the Editor" col¬ 


umn, you say to get Borland 5.0 if you 
need to maintain 16/32 bit code. I have 
used Borland 4.52 for about four 
months and have been unable to find an 
answer to this problem. I want to be 
able to return a floating point number 
from a DLL compiled using the afore¬ 
mentioned compiler to Visual Basic. I 
have been unable to accomplish this 
seemly easy task. Borland hypes being 
able to work with MFC with the new 
product. Does that mean that I will now 
be able to return floats to VB using the 
16-bit compiler? 

Sincerely yours, 

Jim Weller 

This is an old but irritating problem, 
due to the fact that compilers disagree on 
the details of the PASCAL calling 
sequence. You can either blame Borland for 
not changing their compiler to use the 
(slower, less elegant) technique that 
Microsoft C++ uses, or you can blame 
Microsoft for doing their usual lousy job at 
making the specification. Either way, 
you're stuck making your code work. Did 
you ever notice that no function in the 
Windows API returns a POINT? That's 
because returning small structures is 
another area with exactly the same problem 
— compilers disagree on the details. 

How you work around this problem 
depends on your situation. If you get to con¬ 
trol the DLL function, you may want to 
change it so it takes a pointer to afloat, and 
returns the data that way. If you don't get to 
control the DLL function, you'll either have 
to write a wrapper DLL function to handle 
the incompatibility, or else do some hacky 
stuff. The basic secret is that Borland 
returns the float in the DX: AX. Being inexpe¬ 
rienced at VB, I would guess that you can 
declare this DLL function as returning a 4- 
byte integer and then copy that data to a 
variable of type float and make things work 
out. —rib 


From: Kevin Kendrick, 
74577.3443@compuserve.com 

I'm reading through your February 
1996 article in WDJ ("Bypassing Win95 
Printer Device Drivers") — nicely done. 


I have a question. My project requires 
writing directly to the printer on a local 
workstation (either 95 or NT) in the 
immediate mode (no spooling, no driver, 
just ascii dump). In 3.111 can do this and 
the delay is about 1 second. In NT the 
delay is about 15 seconds which is 14 sec¬ 
onds too long. (Printing a receipt where 
average transaction time is only 5 or 6 
seconds.) I'm writing in Delphi but can 
do it in C. Basically, my current routine 
defines a text file, assigns the file to the 
printer port (LPT1), and then writes to 
the text file line by line. Any suggestions? 

That's very weird. It sounds like some 
kind of device timeout is happening, but I 
have no ideas for how to track it down. 
Maybe some reader has seen this problem 
and will respond. —rib 


From: Paolo_Iocco@onde.net (Paolo Iocco) 
Subject: Printing in windows... 

Hi Ron, 

Sorry to trouble you, but one of my 
friends painted you as the guru of win¬ 
dows programming (expecially about 
printing... I've followed your articles in 
WDJ). Is it possible to "split" even and 
odd pages of a document? Let me 
explain: I have a very big file in . PDF for¬ 
mat and I'd like to print even pages on 
the front of a sheet and odd pages on the 
back side. I can do this if I print the 
pages one by one. I want to print all the 
odd pages and then all the even ones, 
but I'd like to use a "software" solution 
(I use Win3.11) that modifies the Print 
Manager or adds something to its "pro¬ 
duction". 

Unfortunately, I'm not much of a guru 
at anything — I just solve the problem in 
front of me and then soon thereafter forget 
how I did it (that's one reason I write arti¬ 
cles, since they help me remember the 
things I once figured out). Off the top of my 
head, I think it would be pretty hard to 
intercept the Windows spooling stream and 
force alternating page output. If any read¬ 
ers out there with printing expertise think 
it's doable, drop Paolo a line (and copy 
met). —rib 
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Hi Ron, 

Just wanted to inform you that I pub¬ 
lished my "Win32 Assembly Language 
Kit" (WALK32) last week. WALK32 is a 
public domain toolkit which contains 
everything an ASM programmer needs 
to write Windows NT and Windows 95 
applications and DLLs, except for an 
assembler and editor. MASM 6.xx is 
required. A386 support in preparation. 
WALK32 comes with full Unicode sup¬ 
port and contains a linker, include files, 
import libraries, an import library cus¬ 
tomization tool, several utilities and lots 
of sample code. WALK32 can be down¬ 
loaded from CompuServe, Forum 
MSLANG, Library 8 (Assembler 
(MASM)), Forum PCPROG, Library 1 
(Assembler), or via FTP from: 

ftp://ftp.franken.de/pub/ \ 
programming/nt/WALK32/WALK32_l.zip 

Perhaps you find this product worth a 
line in WDJ. TIA . . . 

Although I do not intend to write 
Windows programs in assembly language, 
I'm just twisted enough to want to see other 
folks do it. Actually, I can emphathize with 
the motivation — I once actually wrote my 
own stripped C runtime library (in assem¬ 
bly) to reduce the bloat in my applications. 
Unfortunately, it immediately broke when 
the next version of my compiler arrived, 
and I got discouraged. I would note that no 
less a personage than Steve Gibson is also 
writing serious applications in assembly 
language and he has threatened to also 
share his toolkit with WDJ readers — is 
this a bona fide movement? Let's see a show 


of hands, and if there's enough, maybe you 
all should get your own Web site (de 
rigueur for any modern programming 
movement)! —rib 


From: <jeff@signalogic.com> 

Subject: Tech Tip of the year 
Ron, 

My suggestion for Tech Tip of the 
year: Figure out how to allow a 16-bit 
app not marked as 4.0 to be viewed by 
Win95 as 4.0 after it is loaded (or vice 
versa: fool Win3.1x at load time). There 
is no fundamental reason why this can't 
be done if someone were to figure out 
what magical flag deep within Win95 is 
being kept for the app, and simply 
change it. This would allow the 16-bit 
.exe to send/receive Win95 messages, 
get all the bits in calls like 
GetWi ndowLong(GWL_EXSTYLE), subclass 
32-bit wndprocs, etc. — and still be 
loaded under Win 3.lx. 

So much work would be saved! 
Software developers like us who find 
most of our customers still asking for 
3.lx versions would be saved weeks of 
work, would be able to ship less code on 
their diskettes, and would in general 
provide a better product for customers, 
in that customers would see a well- 
adapted . exe spring into "Win95 mode" 
when they did decide to upgrade their 
computer systems. 

Possibly one of your super sleuths 
equipped with debuggers, Soft-ICE, 
etc. could figure this out. Right now. 
I'm working on a little .exe stub that 
runs, determines the operating system 
type, then writes the correct thing in the 
. exe file before Wi nExecing it. But this is 
kludgy, and since we have a lot of 


. exes, will make a mess of our distribu¬ 
tion diskettes and naming conventions. 

Jeff 

I think you're right that however much of 
a hack it might be, this would be a useful 
ability. However much Microsoft might 
wish everyone would just move to Win32, it 
just ain't happening overnight. The fact is, 
by far the easiest way to make a single exe¬ 
cutable support all the Windows platforms is 
with a 16-bit .exe. Matt Pietrek's book 
Windows 95 System Programming 
Secrets shows that at least one place the 
magic flag is stored is in the word at offset 
0x0042 in the message queue. But are there 
other places? And would the same thing 
work under NT? If anyone can perform this 
hack, one of our readers can — anyone out 
there care to sell me a little article that shows 
how to do it? Although slightly less conve¬ 
nient (e.g., won't work great for a single net¬ 
work .exe serving many users), I suspect 
the technique of modifying the . exe is the 
most robust route (and one that ought to 
work fine even on non-Intel NT platforms). 
For some apps, it might be acceptable to just 
supply a menu option that shows how the 
.exe is currently marked and let the user 
change it; the user could then exit and re¬ 
enter the app to have the change take effect. 
Too bad Windows doesn't give us a better 
way out, but you know the Microsoft design 
philosophy — "if we don't need it, why 
would anyone else?". —rib 


From: Chris Dickey 

73311.2101@compuserve.com 

Ron, 

You are a bit of an expert on edit con¬ 
trols so I thought you might have an 
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answer to this one. So far I can't figure it 
out and haven't been able to find anyone 
with a good solution. The question is: I 
need the lower y value of the position of 
a character in a rich edit control. EM_P0S - 
FROMCHAR will give the upper value for an 
entire line of text (not really a single 
character). This is because the line may 
have different sized text or even OLE 
controls. 

There does not seem to be a simple 
way to get the bottom coordinate of a 
single character given its index position 
in the rich edit control. All the character 
heights on a line as well as OLE con¬ 
trols must be evaluated to produce a 
maximum value. This max value can 


be added to the EM_P0SFR0MCHAR value 
to determine the bottom coordinate of 
the character. This means I have to 
evaluate all the text on a line just to get 
the coordinate for a single character. 
Since the caret knows how to position 
itself in a rich edit control, the algo¬ 
rithm to compute the bottom (y value) 
of a line of text must already be imple¬ 
mented. 

Is the API missing or is there an 
undocumented flag which will get me 
the value? Essentially I am trying to 
determine the coordinate and height of 
the caret if the edit control had the 
focus. I can not use GetCaretPos () 
because I need to get the coordinate 


information even when the rich edit 
control does not own the caret. Using 
the y value of the next line doesn't 
work if you are on the last line. Any 
ideas? 

Thanks, 

Chris 

Once again, my expertise is vastly over¬ 
rated and I have no clue (I haven't played 
with the new rich text edit control at all). 
Any readers have the answer? —rib 


Hello Ron, 

A reader has found a problem with 
my code for the long filenames article 
("Using Long Filenames from 16-Bit 
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velopers seeking to integrate advanced 3D ren¬ 
dering technology into a new or existing CAD, 
modeling or visualization application. 

Features a mature, robust 
and proven photo-realis¬ 
tic Tenderer of impeccable 
quality and speed, a hier¬ 
archical database man¬ 
ager, a wide selection of 
3D modeling primitives 
(mesh, patch, NURBs), a 
hierarchical picking 
mechanism and a programmable output driver 
subsystem. Multi-platform: PC (DOS, Windows 
3.1/95/NT, Watcom) & UNIX. See WEB site for 
information, online API, demos and image gal¬ 
lery. $995 and $3500. M/C, VISA. 


Okino 6271 Dorman Road, Unit#6 
Computer Mississauga, Ontario, L4V 1H1 

Graphics, Inc. T: ( 905 ) 672 - 9328 , f: 672-2706 

Email: sales@okino.com, WEB: http://www.okino.com 
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Developer Jobs! 

Internet: ngi@scientific.com 

Commercial software developers should con¬ 
sider registering with Scientific Placement. 
R&D jobs for software engineers, SQA, prod¬ 
uct managers, etc. Nationwide contacts with 
both large and small companies including 
start-ups. Many clients develop commercial 
software products. Most develop for Win¬ 
dows, NT, Macintosh, OS/2, and Unix based 
platforms. We also recruit in other leading 
edge technology areas such as PDA, low level 
ana real-time, compilers, etc. Managed by 
graduate engineers. Send resumd or call for a 
marketability assessment. Never a fee. 

Scientific Placement, Inc. 

800-231-5920 Fax 800-757-9003 
http://www.scientific.com 


CompuServe:? 1250,3001 AOLrdavesmall 
Sm, Box 19949, Houston, TX 77224 
713-496-6100 Fax: 713-496-0373 
SPI8, Box 71, San Ramon, CA 94583 
510-733-6168 Beth@spica.bdt.cora 
SPI8. P. O. Box 202676. Austin. TX 78720-2676 
512-260-0123 lej@zilker.net 


O 
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Add ZIP (and UNZIP too!) to 
your Windows applications! 


YDynaZIP ” 30 

f Data Compression Toolkits 


The new ROYALTY-FREE DynaZIP family of 
developer's tools let you add ZIP and 
UNZIP capabilities to your Windows 
applications. No more “shelling" to 
DOS, no more fussing with proprietary 
compression formats. DLLs, VBXs, OCXs 
and a new database interface provide 
full access from many languages. Fast, 
reliable, and easy to use! 16 and 32 
bit versions, supports long filenames. 


Fully Supported, 
w/30-day no-risk guarantee! 
Call today, toll free: (800) 962-2949 


Inner Media. Inc., Hollis NH USA (603) 465-3216, fax (603) 465-7195 
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shoWbasic 


Demo / Tutorial / CBT / Presentation 
Visual Windows Automation 
Multimedia Authoring Development Kit 

Q Use ShowBasic Recorder to generate the editable, 
mouse/keyboard simulation code invariant to window's 
size and position, screen resolution and video driver. 

Q Achieve visual control over external applications 
and unlimited flexibility by programming in full 
featured Basic extended with the unique presentation 
and CBT related functionality, use even access to 
external DLLs and Windows™ 16-bit or 32-bit API. 

Q Pack your application in a compressed executable 
with the small self-installed run-time and all supporting 
files (BMP. WMF, WAV. MIDI. AVI), compatible with 
Windows 3.1, Windows 95 and Windows NT . 

□ Deliver your titles transparently via WWW - 
ShowBasic can be integrated with any WEB browser. 

Development license $299 unh JO day money back guarantee. Royally free license SX95 

If you don't need all the power of ShowBasic - use our simple. 

yet flexible scripting language for live demos and automation: 

snnDHEJMio -tt^ t . 

Single-user license $30 ($60 Proi Royally free license $300 ($500 Pro). Visa/MC accepted. 

Find more information, demos, samples and evaluation copy: 

http: //www . cn j . digex . net/~milc 

H MI KSoft, I nc. tel/fax: 908-390-8986 

37 Landsdowne Road. Easi Brunswick NJ. 08816 
Internet: mik@cnj.digex.nel CompuServe: 74127.3671 
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0 Design Tool 


•Jr, I 





Customize Code Generation for State 
Diagrams in almost any Language - Ada, 
VHDL, C, Delphi, Pascal, Smalltalk,more 

• Standard Scripts available for C, 
VHDL, C++, Pascal; Custom Reports 

• Template driven code for State, Class 
and Object Interaction Diagrams 

• Reverse Engineer C++, Delphi code 
32, 16 bit WITH CLASS starts at S295 
Call for FREE Eval: 908.6684779 


MICROGOLD SOFTWARE, INC. 

76 Linda Lane Edison, NJ 08820 
www.microsold.com 
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C and C++ DOCUMENTATION 


!! VERSION 6.0!! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates comment- 
blocks for each function, listing the functions 
and identifiers used by it. 

• C-METRIC ($59) Counts path complexity, counts 
comments, code, 'C' statements. 

• C-UST ($69) Lists and action-diagrams, or 
reformats into standard formats. 

• C-REF ($69) Creates cross-reference of local/ 
global/define/parameter identifiers. 

• C-DOC ($199) Package All 5 programs integrated 
as DOS program. <10,000 lines. 

V6.0 C-BROWSE Windows graphic-tree viewer. 

• C-DOC Professional ($299) DOS, Windows, OS/2. 
3-ring binder/case. <1,000,000 lines. 

30-DAY Money-back guarantee. CALL NOW! 


SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga Voice/Fax (905) 858-4466 
0NT Canada L5N-4M1 http://swbs.idirect.com 


Please see Ad Index for our larger ad. 
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' Dazzle/VB - image manipulation. $199 

' VBIite - print/comm/array/B-Tree index .,$149 

' ProMath/VB - numerics/statistics. $149 

' FinLib/VB - financial calculations. $149 

' QuickLine/VB - telephony (multi-line) ...$495 

' SpellCheck/VB - spelling & lookup. $49 

' QB/C/dBase - 15 more DOS libraries ...$call 
' Custom - C, VB, ASM programming ... $80/h 


Develop your VB app faster: Get TeraTech 
tools! Call, E-mail or fax us and well mail you a 
free demo disk ASAP. Or for faster service 
download by F TP or fro m our BBS. Call now!. 

800-447-9120 ext. 1202 

Dept. 1202,100 Park Avenue, Suite 360, Rockville, MD 20850 USA 
Int'l:+1-301-424-3903 Fax:(301)762-8185 BBS: (301) 762-8184 

Copyright TeraTech 1995. Al rights reserve* Trademarks are the property of their holders. 
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Code, WDJ, April 1996). The problem is 
that the SREGS structure is not getting 
initialized before the call to intdosx. In 
real mode, this is not a problem but in 
protected mode, it causes a GPF when 
segment registers are loaded with 
invalid values. The fix is to memsetO 
the SREG structures so that they don't 
contain junk values. Unfortunately, 
this problem didn't show up when I 
tested the Windows version (using 
easywin). 

Robert Mashlan 
rmashlan@r2m.com 
http://r2m.com/~rmashlan 

Thanks for the fix — we will update the 
source code archives. —rib 


From: Philippe Goutier, 

100346.2420@compuserve.com 

Hello, 

I read your article about memory- 
mapped files ("Don't Use Memory- 
Mapped Files, WDJ, April 1996). About 
caching — I did some benchmarks to see 
if the flags FILE_FLAG_SEQUENTIAL_SCAN, 
FILE_FLAG_RANDOM_ACCESS, 
FILE_FLAG_WRITE_THROUGH, (used in 
CreateFile( )) have an effect on MMF. 
The result is that they do have an effect. 

Philippe 

More benchmarks! We need more bench¬ 
marks! Sometimes I amazed at hoio little 
objective measurement has been done of this 


operating system that’s on millions of 
machines. Thanks for the tip. —rib 


From: Bill Jones 

<Bill.Jones@elsegundoca.attgis.com> 
Subject: Paula Tomlinson Article 
Greetings, 

While I found PT's article on Multi 
Threading on NT in your April issue 
informative, I couldn't help but notice 
her blatant echoing of MS marketing BS 
in the second introductory paragraph. 
Her statement about the "easy way" to 
adapt UNIX to MP "versus" NT's SMP 
implementation implies that UNIX's 
MP implementation is more primitive 
than NT's. I know this is a nit, but this 
sort of propagandizing is way out of 
place in a quality technical publication 



Developer's 

Marketplace™ 


S/W ENGINEERING POSITIONS NATIONWIDE 



We Understand 
Programmer’s 
Mind* 


When the country's 
top firms look for 
the best develop¬ 
ers available, they 
turn to Bateman. 
Why? Because we 
specialize in MS 
Windows. NT, OS/ 
2 and Macintosh re¬ 
cruiting nationwide. 
So if it's time for a 
career move, give 
us a call. We un¬ 
derstand your 
skills, and the mar¬ 
ketplace for them... 
we understand you. 


B Bateman Inc. 


5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax: 310-641-2900 
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PROGRAMMERS... 

$100k/yr at HOME! 


My new book, "How To Make $100,000 A 
Year And More Developing Low Budget 
Software Products", will reveal all the 
marketing tricks, strategies, and systems that 
have my business exploding with PROFITS! 

Add your skills to my proven strategies and 
you have the PERFECT BUSINESS ... Low 
overhead, part-time, home-based, huge 
margins, and UNLIMITED POTENTIAL . 


CALL 800-364-4883 


Call TODAY for a FREE special report! 
ULTRA _ Fax: 214-724-0375 

Financial s y a < • m a CompuServe: 71223,634 

1633 Arrowhead Dr, Flower Mound, TX 75028 
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www.dice.com 


DICE is looking for Data Processing, Engineering and 
Technical Writing professionals to fill open positions 
for companies nationwide. 

DICE is a FREE online job search service, providing 
detailed information about current contract and fulltime 
positions across the USA. Please contact by calling ANY of 
these access numbers, using your computer & 1200-9600 
baud Modem, 8-N-l. 


California. 

Georgia 

Illinois 

Iowa 

Massachusetts 
New Jersey 
Texas 
Internet 
Web 


408-737-9339 
404-523-1341 
708-782-0960 
515-280-3423 
617-266-1080 
201-242-4166 
214-691-3420 
telnet dice.com 
www.dice.com 


DATA PROCESSING 
I NDEPENDENT 

Consultant's^ 
Exchange , 


A Service of D&L Online, Inc:. (515) 280-1144 
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C++ Windows Developers 


Compuware Corporation 

has immediate, challenging positions for 
people who have experience with C++/OOD 
Windows Development. We are looking 
for people who are willing to travel, and 
capable of managing projects. 

We offer a pleasant working environment 
that dynamic team players find especially 
attractive and rewarding. 

Contact Lisa Hansen, by phone at 
1-800-527-8462 or 414-225-4000. 

You may also fax your resume to 
414-225-4011. Refer to Dept. CUJ0204. 

For more information, see our home page 
http://www.compuware.com 

COMPUWARE 

Eg An Equal Opportunity Employer 

732 M Jackson Street 
Milwaukee, WI 53202 


Dr. DeeBee® 
ODBC Tools 

Tools for ODBC development 

Ever wonder why 
your ODBC app is not 
working? Why it's just 
too slow? If the ODBC 
driver is OK? 

Dr. DeeBee utilities reveal the inner workings of ODBC. 


Dr. DeeBee ODBC Driver Kit 


Connect proprietary databases to 
Access. Visual Basic, and PowerBuilder 
with our Dr. DeeBee ODBC Driver Kit 




smaaF- - 

RO. Box 91 Kendall, Cambridge, MA 02142 
617- 497-1376 Fax 617-497-8729 
http://www.syware.com 
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Spy on any Windows Program! 


API Vision 



Total detail display for 2000+ APIs in 36 
categories, including base APIs, drivers, 
multimedia, networking, OLE, winsock, 
undoes and more. 

“Insanely Great” 

Software Development Magazine 


Berkeley Toolworks 4,5 

800-593-5103 510-649-9891 apivis@berktool.com 
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$199+18 ship. 

MasterCard, Visa 
30 day money-back guarantee 


STOP WASTING TIME 
CREATING LIST BOXES! 

ListBox Calculator™ 

ListBox Calculator™ eliminates the tedious 
guesswork of setting up list boxes, combo 
boxes, and column headings. Easy to use for 
beginning through advanced programmers. 
ListBox Calculator automatically determines 

• List/combo box width 

• List/combo box tab stops 

• Column heading sizes and positions 

For all languages and most popular fonts 

$49 

Visa, MasterCard 

Sheet Bend Software 

4061 E. Castro Valley Blvd., #197 
Castro Valley, CA 94552 

Phone: 510 581-2671 Fax: 510 581-8350 
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Web Page: http://www.bluewatersystems.coni 

HASSLE FREE HARDWARE CONTROL 

NEW \ ir arw 
l Version 2.01 


flew Features: 
•Script 
Language 
•if-else 
-while!) 
-Arrays 
•Faster 
Execution! 
-Avg.15% 
speed 


Windows95"« .. ---►fir 


Binary Compatible 

Spend your time writing your App...not 
wading through D.D.K. documentation! 
Fast hardware control under Win32* 
without the device driver kit! 

/PortI/O / MemoryI/O /Interupts 

_ OCX version also available 

Ask us about Alpha™, PowerPC™ 4 MIPS versions 
NO RUNTIME ROYALTIES 

VISA, MC, AMEX i Approved P.O. accepted 
Tel (206)771-3610 -Fax (206)771-2742 
E-Mail: info@bluewatersystems.com 

(800)962-2114 _ 
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CAREER OPPORTUNITIES 


Work in beautiful Marin County in the 
San Francisco Bay Area. 

Light Source is looking for Windows 
engineers with commercial application 
development experience, including extensive 
Ul work, using MFC, Windows95, C++ and C. 

• SOFTWARE PROJECT LEADER 

• SENIOR SOFTWARE ENGINEER 

• SOFTWARE TOOLS AND BUILD ENGINEER 

For more information, call Leslie Evans at 
415.925.4227 or just fax your resume to 
415.461.8011. Emailleslie@ls.com Check 
out our web site at www.ls.com and our 
WDJ recruitment listing at www.wdj.com/ 
recruit.htm 

LIGHT O SOURCE 
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Phone Sound: Simple! 

For Windows/DOS Voice Mail & Fax Developers 



Professional 
Tools for 
your Voice 
Mail, Fax & 
Audiotex 
Applications 


1. Create fantastic prompts 
and save time with VFEdit®'. 
Record, crop, cut, copy, paste, 
mix, fade, echo, volume & 
more with your Dialogic™ 
D4x/12x boards. 

2. Add Voice Mail power to 
your MS Windows apps with 
TI/FDLL ™, our Tel I/F 
Dynamic Link Library. 

3. Scribe plays digital audio 
files without voice hardware! 


4 . Add Text-to-Speech 

capability with Vox Fonts™, 
our text-to-speech library! 

5. Audio Tool Box™ 
converts between Multimedia 
Wave (16, 8 & MS ADPCM), 
unsigned 8, linear 16, CCITT 
G.711/G.722, Dialogic 4/8 & 
more! Batch convert, crop, 
chop, normalize & filter. Add 
conversion to your apps with 
our ToolBox SDK'. 


VS/ Order Now! 800-234-VIS1 


VISI, 2118 Wilshire Blvd, #973, Santa Monica. Ca 90403; 310-392-8780 
Fax 800-234-FX1T / BBS: 310-392-6610 (Download our Worionq Demos) 
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The Fastest xBASE 



for C, C++, Visual Basic and Delphi 
database application programmers! 
With CodeBase 6.0, you get: 


• Multi-user compatibility with 
FoxPro, Clipper and dBASE files. 

• Portability between Windows, 

Win95, NT, DOS and UNIX. 

• Support for the popular C/C++ 
compilers, Visual Basic and Delphi. 

• Data aware controls for Windows. 

• Powerful visual report writer. 

• Client/Server option. 

• Royalty Free distribution. 

g mi 30 (My — 


Call Sequiter Software Inc. for details! 
Phone: 403 437 2410 FAX: 403 436 2999 
Internet: sequiter@supemet.ab.ca 
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The best high 
performance, 
portable 
compression 
libraries for 


DOS, Windows, 
OS/2, Unix, 
Macintosh, 
embedded systems, 
and practically anything 
else, period. 


FREE DEMO 

DOS $249 
Win 16 $299 

Win32 $299 
OS/2 $349 
Unix $349 
Macintosh $299 

RJ DC Micro 
mSst Development 


45-function API 
Buffer compression 
File compression 
Disk spanning 
Encryption 
Self-extracting EXE's 
VBX/OCX controls 
On-line help 
Full source code 

Tel 606-268-1559 
Fax 606-266-0726 


Call 1-800-775-1073 

info@dcmicro.com http://www.dcmicro.com 
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Basic Scripting 


Cypress Enable 2.5 
Basic Scripting for Applications 

A powerful, complete, royalty free, VBA 
compatible, embeddable Basic Scripting 
Language. Cypress Enable Features: Royalty - 
free licensing, 30 day money back guarantee, 
OLE 2.0 Automation, Direct access to C-++ 
objects, Dynamic Dialogs, Dialog Editor, 
Debugger (w/source), Named parameters, 
Easily extended, Printed & on-line 
Redistributable end-user documentation, Small 
footprint engine < 200K, Free tech support. 16 
bit $495, 16 & 32 bit in one box $995. For free 
whitepaper call: 1-800-790-4050 or visit our 



email cypress@cypressinc.com 
Fax:(602) 951-8047 www.cypressinc.com 
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The Weekly MFC Extension 

a The only MFC extension class library that 
delivers new class(es) every week 
0 Updated through eMail 

0 Includes all classes available upon subscription 
0 Free sample classes available as demo 
0 Only $150 annual subscription 

Octo+ Dataview 

The Dataview client OCX and OLE server turn 
any ODBC compliant database into an advanced 
Client/Server environment. The OCX displays 
data through a user friendly grid. The 32bit 
multithreaded OLE automation server services 
remote OLE requests through high level objects. 
Includes SQL wizard that generates advanced 
dataviews (for local and remote databases) in 
minutes without requiring SQL knowledge. 

Only $299 

Contact eMail: info@periphere.com 

http://www.peripherc.com 
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such as yours. I've been developing 
SMP device driver for UNIX for several 
years, and have recently started ramp¬ 
ing up to do similar development on 
NT. I can tell you that NT has a long long 
way to go before it can match UNIX's 
SMP capabilities, MS's marketing hype 
not withstanding. 

Ms. Tomlinson's subtle assertion, 
appearing as it does in a technical article, 
lends an unwarranted verisimilitude to 
MS's posturing. 

That was text I introduced during edit¬ 
ing, so the blame lies with me (which is 
really good, because this will help balance 
out the MS bashing I'm often accused of!). 
The point was meant to be historical (with 


UNIX as only an example past data point), 
and I believe it is accurate in that context. 
I think I could have picked OS/2 (but was 
afraid it would look like bashing OS/2) as an 
equally valid example — attempts to graft 
SMP on after the O/S is designed in both 
cases have produced MP, but not very sym¬ 
metric MP. 

I didn't mean to imply that all UNIXs 
are in the state of the first attempts to sup¬ 
port MP in UNIX were (i.e., there are 
UNIXs that really were designed from 
scratch to support SMP); my intent was 
just to point out the difference between 
SMP and MP and why it's an important 
difference. Looks like I implied things I did 
not intend to; thanks for pointing that out. 
—rib 


]From: jkristof@pip.dknet.dk 
Subject: March Vol 7 Number 3 
To the editors: 

I have just read the article "A VxD to 
Monitor Hardware Interrupts" by Jean- 
Fran<;ois Larvoire, and I must say that it 
is just this kind of in-depth research 
which makes Windows Developer's 
Journal worth reading. The author pre¬ 
sents a "gold mine" of hard facts in a 
educational and pleasant way. 
Afterwards you really know how to do 
it. 

Thanks, 

Jan Kristoffersen 


rf=2b 

ZIP 


XCEED ZIP 

COMPRESSION LIBRARY 


FOR VISUAL BASIC AND DELPHI 


Finally, a compression component that 
gives you your money's worth! Add 
Xceed Zip to your project, set a few 
properties, and your apps will be ziping 
and unziping in minutes. Great for 
automating backups, preparing files 
for transmission, or developing your 
own custom installer. 





( 800 ) 865-2626 
( 514 ) 442-2626 


Visit www.xceedsoft.com for a 
free trial version and find out 
why Xceed Zip is rapidly becoming 
the most popular VB and Delphi 
compression library! 
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C, C++ and Delphi Libraries 
for Windows and NT 

G_FFT Class Library 3.10: Extremely high 
speed Signal Processing routines, Real, 
Complex FFT, Correlation, Convolution, 
Amplitude, Power Spectrum, Filtering, 
Decimation, Data Smoothing, Windowing, 
sorting and more. $149 
G_FFT Professional: Includes G_FFT and 
supports Virtual Memory. Converts over 2 
billion data points. $199 
OOPIot Class Library 3.10: Plotting and 
charting, Linear, Log, Log-Log, Scatter, Bar, 
Pie, Origin setting, Scaling, Real 
Coordinates not integer, MDI support and 
much more. $149 

OOParser Class Library: Expression and 
function evaluator with 1,2, & 3 variables 
and unlimited parameters. $79. 

Sigma Software, Inc. 

15779 Columbia Pike, Suite 360 
Burtonsville, MD 20866 
Call or Fax your order: 301-549-3320 
BBS 301-549-4161 
Download Demo from our BBS. 
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Bar Codes Can Be Fun. 
Honest! 

If you can change fonts, you can 
create bar codes. Code 128, Code 
39, UPC, and other symbologies. 



azalea 

software inc. 


800 48-ASOFT 
206 932.6028 
info@azalea.com 
www.azalea.com 
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WINGRAF2.0 INGRAF 7.0 

(Win 3.1, Win95, WinNT) (DOS/DOS extenders) 


WINGRAF& INGRAF are Graphics libraries 
for Scientific, Engineering and Business 
applications. Each library contains over 150 
routines to draw linear, log, log/log, polar, 
smith, bar, pie, scatter, high-low-close plots 
on VIDEO, PRINTERS and PLOTTERS. 
C, PASCAL, DELPHI, BASIC, and 
FORTRAN language versions. 

NO ROYALTIES 
FULL SOURCE CODE 

Sutrasoft 

P.O. Box 1733 
Sugar Land, TX 77487-1733 
TEL: (713) 491-2088 
FAX: (713) 240-6883 
76163.1164@COMPUSERVE.COM 
VISA, MC, AMEX & DISCOVER 
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WINDOWS DEVELOPERS 

As a headhunter focusing on one area of 
software engineering, I believe I can find you 
the best opportunities. Through constant 
networking I learn of positions all over the 
country. All fees are paid by the client 
company. The market is excellent for talented 
windows developers. Give me a call at 
1 -800-638-8903. (Gary_Patton@cma-tssidnvr.com) 
— Gary Patton 
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Visit our Internet site at http://www.accusoft.com 


Platforms 

Supported 


The Ultimate High Performance Imaging Toolkit! 

Add Support for Over 36 File Formats Instantly ! 


Now with PNG!* 


PERFORMANCE 


crAMM1Mr IMAGE EXPOI 
SCANNING GUARANTEE 


WVHiilllMW UUAKAN I tt 

THUMBNAILS PRINTING jo JsE. 

IMAGE SCALE TO 36 FILE 
PROCESSING GRAY FORMATS 

COMPRESSION IMPORT COLOR 




CONVERSION REDUCTI< V 


QUALITY 


AccuSoft Image Format Library 5.0 


Ultimate Imaging Toolkit 

AccuSoft provides the ultimate imaging 
toolkit solution with the highest 
performance, most formats & platforms, 
most complete API and the best pricing. 
That is why we are the industry leader 
and why over 5000 companies have 
chosen AccuSoft for their imaging 
needs! 

Performance 

AccuSoft has always been known as the 
performance leader. We know that you 
want the fastest imaging possible and 
that fast is never fast enough. 

Therefore, we constantly work on 
improving performance to keep us 
(and you) ahead of the competition. 

Quality 

AccuSoft has become the leader in 
imaging toolkits due to our untiring 
commitment to quality. Not just 


Toll Free: (800) 525-3577 

Internet: http://www.accusoft.com 
CompuServe: Go AccuSoft 


product quality, which can be seen in design is tailored for easy 

our unique guarantees, but also service porting, and since we 
quality from our special fast delivery support ALL platforms, 

program, top rated technical support and your products can be sold to 
rock-solid technology. every market. 

Pro Gold Order Today 

The Pro Gold versions of our imaging Call now and you can start 
toolkits are unbeatable for performance writing high performance 
and special features like scale to gray, imaging applications in less 
sub-degree rotation, sub-second than an hour. Our unique 30 

decompress & display, sub-second minute delivery program is 

screen rotation, huge image handling also the fastest in the 

and more. business! 

If you want the best performance 
available anywhere at any price, this is 
it. 

Cross Platform 

With this toolkit, you can sell your 
applications on many different platforms 
without having to recode the imaging 
portion. AccuSoft's cross platform 


AccuSoft 

High Performance Imaging" 



Two Westborough Business Park Westborough, MA 01581 Tel (508) 898-2770 FAX (508) 898-9662 

All company and brand names are trademarks or registered trademarks of their respective owners. 

*Free Upgrade for 5.0 users. PNG is the replacement format for GIF. 1. Raster only 2. Read only (Does NOT require separate DLL from Kodak.) 
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Announcing BoundsChecker 4.0 

Because There's More To Windows Error Detection 
Than Finding Memory Errors 



Time For A Change ... Use BoundsChecker 4.0 
Today's error detection challenges go far beyond C/C++ 
memory corruption and leaks to include much larger prob¬ 
lems. Interfaces and software layers are growing at a 
faster pace than most developers can keep up with. Tools, 
libraries, and components are isolating the developer from 
the actual interface with wrappers. And, many of the most 
costly bugs are interface-related and often several layers 
away from the source code. You need one tool that does 
the whole job. You need BoundsChecker! 


"Smart Debugging"™ For Visual C++ Users 
Along with power and visibility, BoundsChecker 4.0 
achieves new levels of ease of use. BoundsChecker is now 
seamlessly integrated into the Microsoft Visual C++™ debug 
ger. Because it is fully hosted by the IDE you can view your 
errors and immediately go to the offending source code. 
Every time you debug, BoundsChecker is transparently 
working to find additional hidden, costly bugs. By finding 
these bugs earlier in the process you will release higher 
quality software sooner. 


Here's Why: 

NuMega's BoundsChecker solves many of the complex 
interface-related problems that Windows developers are 
likely to encounter. If you are building COM-based 
software or using the Microsoft® Internet interfaces and 
APIs, BoundsChecker 4.0 is invaluable. It intercepts control 
and validates interfaces in thousands of strategic places, 
automatically pin-pointing errors. The event window then 
shows a step-by-step, layer-by-layer history of events that 
gives a clear picture of what software components were 
responsible. Because C/C++ memory bugs and leaks can 
still appear, BoundsChecker Professional Edition includes 
CTI™, the most advanced memory and leak detection 
technology available. No other debugging tool offers so 
much power and visibility. 


New In BoundsChecker 4.0 

Parameter validation and logging of OLE interfaces 
Parameter validation and logging of Microsoft Internet 
interfaces and APIs 

User-extensible API validation (Validate your own APIs) 
"Smart Debugging" with the Visual C++ debugger 
(Evaluates each line of code for errors as you debug) 
Supports Borland Delphi® applications 

Call 1-800-4-NUMEGA to order! 
Contact our web site to learn more about the 
exciting new features of BoundsChecker 4.0 
http://www.numega.com/bc4.html 
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